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
ZG DFS3649=IMS
ZG SOFLOGID=
ZG SOFLOGID=D0