Customizing global options (SYGWMCST)

SYGWMCST, one of the macros in table SYGWXCPH, provides options for customizing the the Client Option and the Server Option. Some Server Option parameters are used only for customizing the DB2 UDB Option for CICS. You can customize SYGWMCST using the provided JCL member.

Table A-1 describes SYGWMCST parameters. Except where noted, these apply to both the Client Option for IMS and Server Option for IMS.

Table A-1: Complete list of SYGWMCST parameters

Parameter

Default

Format

Purpose

ACCESSCODE

(Server Option only)

blank

Up to 32 characters

Defines an access code, which is then compared to the access code supplied by Server Option programs using TDGETUSR.

If the access codes do not match, the client password is not returned to the caller of Server Option programs using TDGETUSR.

See the appropriate Mainframe Connect Server Option Programmers Reference for details on TDGETUSR.

ACCESSCODESW

(Server Option only)

N

Y or N

Turns on/off access code comparison (see ACCESSCODE value).

When ACCESSCODESW=N (default), the logged-in password is always returned to the caller of Server Option programs using TDGETUSR.

When ACCESSCODESW=Y, the logged-in password is returned only if the access code passed to TDGETUSR matches the access code specified in SYGWMCST ACCESSCODE.

CHARSETSRV

iso_1

Up to 32 characters

Specifies the default character set that the Client Option or Server Option uses internally. The valid values are iso_1 and utf8.

NoteThe value utf8 is valid only if USEIBMUNICODE is set to Y.

DEBUGSW

N

Y or N

Specifies whether or not debugging messages, used in troubleshooting, should be displayed in the system log.

DECPOINT

(Server Option only)

’.’

Either a decimal point or comma delimited by single quotation marks

Decimal point indicator, used only with the DB2 UDB Option for CICS.

DEFLTPROTOCOL

TCP

TCP

Specifies the default network driver protocol.

DQUOTETRAN

(Server Option only)

Y

Y or N

Used only with the DB2 UDB Option for CICS. Make this setting consistent with your DB2 configuration.

When DQUOTETRAN=Y (default), double quotes are translated to single quotes in incoming SQL text.

If you are using an ODBC driver, set DQUOTETRAN=N.

NoteIf you are using double-byte or multi-byte characters for DB2 metadata, set DQUOTETRAN=N.

IMSLOGTYPE

(IMS TM only)

A1

A value greater than or equal to A0

Specifies a log type. IMS TM reserves values less than A0.

LONGVARTRUNC

N

Y or N

Indicates whether to truncate LongVarChar and VarBinary.

For CICS only: Coordinate this setting with the DirectConnect for z/OS Option TRS. If either this parameter or the TRS TruncateLV configuration property is set for truncation, truncation occurs. If you do not want truncation, set this parameter to N and make sure the TRS TruncateLV configuration property is set to No. See the Mainframe Connect DirectConnect for z/OS Option Users Guide for Transaction Router Services.

MVSDDNAME

(IMS TM and MVS only)

blank

From 1 to 8 characters

The DD name of the MVS Open Client and Open Server log file. If this parameter is left blank (the default), MVS transactions are not logged. If you enter a DD name of 1-8 characters, MVS transactions are logged. The name specified here must match a DD name specified in each MVS transaction profile job.

MVSDDNAME must match a DD name specified in the JCL for one of the following:

  • An MVS job

  • An MVS started task

  • The MVS transaction profile (if run in an APPC initiator as a transaction)

NATLANGUAGESRV

us_english

Up to 32 characters

Designates the default national language used by the Client Option or Server Option. Also see the CHARSETSRV property.

ROWLIMIT

(Server Option only)

0 (zero)

Used only by the DB2 UDB Option for CICS:

  • ROWLIMIT=0 – there is no limit to the number of rows that can be sent.

  • ROWLIMIT=nn indicates the global limit of rows that can be sent.

USEIBMUNICODE

N

Y or N

Specifies whether Unicode support for a particular z/OS installation is enabled through the IBM conversion environment and services.

  • If USEIBMUNICODE=Y, IBM support is used for character set conversions.

  • If USEIBMUNICODE=N, conversion is accomplished through the product-supplied translation tables.

NoteIf USEIBMUNICODE=Y, all character sets that are to be used at a particular site must have entries created with the SYGWMCXL macro.

See “Using the IBM z/OS conversion environment and services”.