ZG - Global options control statements (dynamic refresh)

This reference topic describes how to add or modify global options control record fields that are dynamically refreshed and do not require an IMS restart.

The following keyword parameters can be specified:

ASOT=
This represents the automatic signoff time. The numeric value must be 0, or within the range of 10 - 1440.
ALOT=
This represents the automatic logoff time. The numeric value must be 0, or 10 - 1440.
BYPDYNDEQ=
Specifies whether the dequeuing of messages is included as part of signoff cleanup for dynamic SLU2/3270 devices.
Y
Signoff cleanup does not include dequeuing messages for dynamic SLU2/3270 devices.
N
Signoff cleanup includes dequeuing messages for dynamic SLU2/3270 devices.
BYPSTATDEQ=
Specifies whether the dequeuing of messages is included as part of signoff cleanup for static SLU2/3270 devices.
Y
Signoff cleanup does not include dequeuing messages for static SLU2/3270 devices.
N
Signoff cleanup includes dequeuing messages for static SLU2/3270 devices.
CONVREC=
Specifies how IMS manages conversational status. The value you specify is overridden if the device default is also provided.
Y
Specifies that if SRMDEF global/local is set, conversational status is recoverable.
N
Specifies that conversational status is not recoverable.
(blank)
If no option is specified, conversational recovery is managed based on the:
  • Setting in the DFSDCxxx PROCLIB member
  • IMS system default
DFS3649=
Specify one of the following options for processing the DFS3649 signon panel:
  • DFS3649=IMS (for the IMS default panel)
  • DFS3649=DFS2002 (to get message DFS2002)
  • DFS3649=ETOS (to get IMS ETO Support provided signon panel)

    If DFS3649=ETOS is specified, you can also use the PASSSIZE= parameter to specify whether to use the IMS ETO Support password signon or the passphrase signon.

  • DFS3649=DFSGMSG1 (for user DFSGMSG1 greetings exit)
  • DFS3649=MOD (for user-supplied MFS mod name)

    If DFS3649=MOD is specified, you must also specify MOD3649=<modname>.

DFS3650=
Specify the option for processing the DFS3650 session status panel:
  • DFS3650=IMS (for the IMS default panel)
  • DFS3650=DFS058 (to get message DFS058I)
  • DFS3650=BLANK (to get a cleared panel)
  • DFS3650=DFSGMSG1 (for user DFSGMSG1 greetings exit)
  • DFS3650=MOD (for user-supplied MFS mod name)

    If DFS3650=MOD is specified, you must also specify MOD3650=<modname>.

  • DFS3650=DFS2002 (to get message DFS2002)
DFSYPRX0RC=
Specifies the return code that is set in the IMS ETO Support version of IMS user exit DFSYPRX0. IMS ETO Support supports return codes 0, 4, and 8.

For more information about these return codes, see the topic "OTMA Destination Resolution exit routine (DFSYPRX0)" in IMS Exit Routines.

DYTXCRE=
Specifies whether IMS ETO Support allows transactions to be created dynamically.
Y
IMS ETO Support allows transactions to be created dynamically.
N
IMS ETO Support does not allow transactions to be created dynamically.
FPREC=
Specifies how IMS manages Fast Past status and message disposition. The value you specify is overridden if the device default is also provided.
Y
Specifies that if SRMDEF global/local is set, Fast Path status and messages are to be recoverable.
N
Specifies that Fast Path status and messages are not recoverable.
(blank)
If no option is specified, Fast Path status and message recovery is managed based on the:
  • Setting in the DFSDCxxx PROCLIB member
  • IMS system default
LOGON=
The following options can be specified:
  • LOGON=ETOS (to use IMS ETO Support process)
  • LOGON=DFSLGNX1 (to use DFSLGNX1 user exit)
  • LOGON=AUTO (to use IMS ETO Support auto signon feature)
MOD3649=
Specify the 1- to 8-character alphanumeric MFS mod name. This parameter is valid only if DFS3649=MOD is also specified.
MOD3650=
Specify the 1- to 8-character alphanumeric MFS mod name. This parameter is valid only if DFS3650=MOD is also specified.
PASSSIZE=
You can specify one of the following options if DFS3649=ETOS is also specified.
  • PASSSIZE=P (to use IMS ETO Support passphrase signon panel)
  • PASSSIZE=W (to use IMS ETO Support password signon panel)
  • PASSSIZE= (to specify that the signon panel is to be determined by the MFSPPDEF parameter of the DFSDCxxx PROCLIB member).
    • MFSPPDEF=Y (to use IMS ETO Support passphrase signon panel)
    • MFSPPDEF=N (to use IMS ETO Support password signon panel)

If this parameter is not specified and DFS3649=ETOS, the default is PASSSIZE=.

QNAMING=
The following options can be used to determine the USER / LTERM structure names:
  • QNAMING=IMS (for the IMS default)
  • QNAMING=NUL (for NODE=USER=LTERM)
  • QNAMING=USER (to specify a user from the table)
  • QNAMING=SUFFIXED (to specify a suffixed user ID)
  • QNAMING=DFSSGNX1 (for user-supplied DFSSGNX1 exit)
  • QNAMING=APPEND@ (to specify user ID plus "@" character)

If QNAMING=USER is specified on the Global Options record, it merely sets the default action for ETO support processing. In order to actually obtain the USER / LTERM from the table, a User ID or Node record needs to be created defining the USER / LTERM names to be used.

SOCLEAN=
Specifies whether signoff cleanup is performed for SLU2/3270 devices.
Y
Signoff cleanup is performed for dynamic SLU2/3270 devices, and signoff cleanup is performed for static SLU2/3270 devices if STATIC=Y is also specified.
N
Signoff cleanup is not performed.
SOFLOGID=
Signon failure log record ID

Use this option to specify whether IMS ETO Support will create an IMS log record for certain signon failures. This option is used when a signon fails because the SLU2 / 3270 - "USER RECORD REQUIRED FOR SIGNON" is set to "Y" and no record exists in the IMS ETO Support User table for the user ID attempting signon.

IMS ETO Support will create the log record when all of the following conditions are true:
  • User Record Required For Signon in the SLU2 / 3270 device record is on (ZD SGNUSREC=Y)
  • Signon Failure Log Record ID = a valid hexadecimal value (SOFLOGID=xx, where xx is any valid hexadecimal value)

IMS ETO Support does not create a log record if either of the above conditions is untrue.

If SOFLOGID= is specified, this field must contain 2 characters that can be converted to hexadecimal characters (such as 0 - 9, A - F). Valid values for this field are X'D0' - X'FF'.

SRCHPRTOTMA=
Specifies whether the Printer LTERM table is searched for CHNG calls to the alternate PCB for messages originating in OTMA.
Y
A CHNG call to the alternate PCB for messages originating in OTMA results in searching the Printer LTERM table.
N
A CHNG call to the alternate PCB for messages originating in OTMA does not result in searching the Printer LTERM table.
SRCHSEQ=
Specifies the IMS ETO Support table search sequence for SLU2/3270 devices. The options are:
USERID
The user ID table is searched before the Node table. The exact sequence is: User ID/Node/Device Global/Global.
LUNAME
The Node table is searched before the user ID table. The exact sequence is: Node/User ID/Device Global/Global.
SRMAFF=
Specifies whether signon is allowed when an IMS Resource Manager (RM) affinity exists.
Y
Signon is allowed even though an IMS Resource Manager (RM) affinity may exist.
N
Signon is not allowed if an IMS Resource Manager (RM) affinity exists.
(blank)
If no option is specified, sign-on with IMS Resource Manager (RM) affinity is determined based on:
  • Setting in the DFSDCxxx PROCLIB member
  • IMS system default
SRMDEF=
Specifies the status recovery mode. The value you specify is overridden if the device default is also provided.
GLOBAL
The IMS Resource Manager (RM) is to maintain terminal and user end-user status.
LOCAL
Terminal and user end-user status is to be maintained in local control blocks and log records.
NONE
Status is to be discarded at signoff/logoff/IMS restart.
(blank)
If no option is specified, status is maintained based on the:
  • Setting in the DFSDCxxx PROCLIB member
  • IMS system default
STATIC=
Specifies how IMS ETO Support deals with statically SYSGENed SLU2 / 3270 terminals.
Y
IMS ETO Support processes static SLU2/3270 terminals.

Some of the tasks IMS ETO Support performs for static SLU2/3270 devices include:

  • Displaying user-defined signon needed, and signon completed screens
  • Performing signoff cleanup processing
N
IMS ETO Support does not perform any processing on statically SYSGENed terminals.
STSNREC=
Specifies how IMS manages STSN (set and test sequence numbers).
Y
Specifies that if SRMDEF global/local is set, STSN is recoverable.
N
Specifies that STSN is not recoverable.
(blank)
If no option is specified, STSN recovery is managed based on the:
  • Setting in the DFSDCxxx PROCLIB member
  • IMS system default
UIDSUF=
Specifies the user ID suffixing technique to be performed by IMS ETO Support. The options are:
STD1
A 1- to 7-character user ID is suffixed with a single byte from the 0 - 9, A - Z range. IMS ETO Support returns to IMS the first user ID + suffix that creates a name unique within IMS.
HEX3
A 1- to 5-character user ID is suffixed with 3 bytes from the 000 - FFF range. IMS ETO Support returns to IMS the first user ID + suffix that creates a name unique within IMS.

For a 6-character user ID, IMS ETO Support appends a value in the 00 - FF range.

For a 7-character user ID, IMS ETO Support uses a suffix with a value in the 0 - 9, A - Z range.

X40STD1
For all but the initial signon, a 1-character suffix is appended to the user ID to create the USER/LTERM blocks. The initial signon will not have a value appended.

The appended values consist of 1 to 9, and A to Z.

X40HEX3
For all but the initial signon, up to 3 characters are appended to the user ID to create the USER/LTERM blocks. The initial signon will not have a value appended.

If the user ID is 7 bytes, IMS ETO Support automatically switches to UIDSUF=X40STD1.

For user IDs of 5 characters or less, the appended values consist of 001 to FFF. For 6-character user IDs, the appended values consist of 01 to FF.

UMFS3650 =
Specifies whether (YES) or not (NO) IMS is to send the DFS3650I message to the User MOD. This option is relevant only when DFS3650=MOD is active for the device signing on.
YES
IMS sends the DFS3650I message to the user MFS MOD.
NO
IMS does not send the DFS3650I message to the user MFS MOD.

Examples:

The following control statement changes the default ASOT value to 90: 

   ZG ASOT=90
The following control statement changes the default signon panel to use the IMS default: 
   ZG DFS3649=IMS
The following control statement with blanks specified removes any values contained in this field, and thereby turn off signon failure log record creation. 
	ZG SOFLOGID=
The following control statement causes an IMS log record with a hex D0 (X'D0') to be written when signon fails because no matching entry exists in the IMS ETO Support USER table. 
	ZG SOFLOGID=D0