The /OPNDST Command Without the USER Keyword. Use this form of the command for all static and ETO terminals except ETO SLU P and Finance terminals, ETO output-only devices, and all ISC parallel sessions.
.---------------. V | >>-+-/OPNDST-+--NODE--+---+-nodename--+-+-+---------------------> '-/OPN----' | '-nodename*-' | '-ALL---------------' >--+----------------+--+---+--+--------------------+----------->< '-MODE--modename-' '-Q-' '-LOGOND--logondname-'
The /OPNDST Command With the USER Keyword for Non-ISC. Use this form of the command for:
>>-+-/OPNDST-+--NODE--nodename--USER--username------------------> '-/OPN----' >--+------------+--+----------------+--+---+--------------------> '-ID--idname-' '-MODE--modename-' '-Q-' >--+--------------------+--+------------------+-----------------> '-LOGOND--logondname-' '-USERD--userdname-' >--+-----------------+----------------------------------------->< '-UDATA--userdata-'
The /OPNDST Command With the USER Keyword for ISC. Use this form of the command for all ISC parallel sessions, both static and ETO.
>>-+-/OPNDST-+--NODE--nodename--USER--username------------------> '-/OPN----' >--+------------+--+----------------+--+---+------------------->< '-ID--idname-' '-MODE--modename-' '-Q-'
Table 85 lists the environments (DB/DC, DBCTL, and DCCTL) from which the command and keywords can be issued.
Command / Keywords | DB/DC | DBCTL | DCCTL |
---|---|---|---|
/OPNDST | X | X | |
ID | X | X | |
LOGOND | X | X | |
MODE | X | X | |
NODE | X | X | |
Q | X | X | |
UDATA | X | X | |
USER | X | X | |
USERD | X | X |
/OPNDST is a multisegment command that causes IMS to initiate a session with a VTAM terminal and, if the USER keyword is specified, the user is signed on automatically to the VTAM terminal after successful session initiation. All forms of logging-on a remote VTAM terminal to IMS, including the use of /OPNDST, do not work until the /START DC command has been entered and accepted by IMS.
All /OPNDST formats require an EOM indication to denote end-of-message. An EOS indication must be included for all segments that precede the last segment. See Multisegment Command Input for more detail on using EOM and EOS.
You can issue /OPNDST on the XRF alternate to restart a failed backup session for a class 1 ETO terminal. To do this, the node and the user structure must still exist and be coupled together, and an active session must exist on the active system. If the node and the user are not coupled, or an active session does not exist on the active system, the command is rejected.
/OPNDST NODE ALL opens sessions for all static terminals except ISC parallel sessions. The command has considerable concurrent activity, both for IMS and for VTAM. Ensure that the system has sufficient pool sizes, buffer sizes, and number of concurrent IMS tasks defined.
If the USER keyword is not specified in the command, the NODE parameter can be generic or ALL, or a range of static nodes, or there can be multiple NODE parameters. If a generic, ALL, or range of node names is specified, any nodes defined with users are ignored and flagged with an error message.
The /OPNDST NODE USER command signs on and logs on a user at the same time, except for ISC terminals. On ISC terminals, the session is allocated. The following list includes sample /OPNDST NODE USER commands:
/OPNDST NODE nodename USER username UDATA userdataThis command marks a statically defined terminal as signed on by the user.
/OPNDST NODE nodename USER username MODE modename LOGOND logondname USERD userdname UDATA userdataThis command creates the terminal and user structures, and allocates the newly created user structure to the terminal structure created to indicate signed on status.
/OPNDST NODE nodename USER username ID idnameThis command finds the subpool structure and allocates the subpool (user) structure the statically defined static ISC terminal. user issues the /SIGN command.
/OPNDST NODE nodename USER username ID idname MODE modename LOGOND logondname USERD userdname UDATA userdataThis command creates the terminal and subpool (user) structure and allocates the newly created user structure to the terminal structure created. defined by the SUBPOOL name in RACF until the user issues a /SIGN command.
To restart failing ETO sessions (for example, ETO only or printer sessions), use the /OPNDST NODE USER command.
In an IMSplex, /OPNDST NODE specifies a VTAM node with which IMS initiates a session. Specify ROUTE(imsid), if you want to log the node onto a particular IMS. If ROUTE(imsid) is not specified, and /OPNDST is routed to all the IMS systems, IMS will process the command only on the IMS system designated as the command master. If the ROUTE keyword specifies multiple IMS systems so that the /OPNDST is routed to more than one IMS systems, IMS will process the command only on the IMS system designated as the command master. On the other IMSs, the /OPNDST command will be rejected.
The /OPNDST NODE Q command also allows IMS to request another subsystem to share a node (usually printers) with IMS. If the other subsystem is using the printer, VTAM queues the SIMLOGON request for IMS for the printer, schedules the owning subsystem's RELREQ VTAM exit, and acquires the printer for IMS after the current owning system releases the printer. Multiple requests for the same printer are queued by VTAM for processing.
The /DISPLAY NODE command is used to determine whether IMS has acquired the printer.
The UDATA keyword is valid only if the USER keyword and parameter are also specified. The UDATA keyword is valid for static and dynamic users. It is not valid for ISC nodes. The user data can be up to 256 bytes long.
The USER keyword applies to ISC sessions when allocating a user to an ISC node, to dynamic users when signing a dynamic user on to a dynamic node, and to static user IDs when signing a user on to a static node.
USER username must be specified to open parallel session ISC nodes with users. It must not be specified for a single session ISC node.
Entry ET:
/DIS NODE L3270*
Response ET:
NODE-USR TYPE CID RECD ENQCT DEQCT QCT SENT L3270A 3277 00000000 0 0 0 0 0 IDLE C1INOP STATIC L3270B 3277 00000000 0 0 0 0 0 IDLE C1INOP STATIC L3270C 3277 08000002 44 45 45 0 80 CON STATIC L3270D 3277 00000000 2 0 0 0 7 IDLE STATIC *94307/145048*
Entry ET:
/OPNDST NODE L3270*
Response ET:
DFS058I OPNDST COMMAND COMPLETED
Entry ET:
/DIS NODE L3270*
Response ET:
NODE-USR TYPE CID RECD ENQCT DEQCT QCT SENT L3270A 3277 06000004 0 0 0 0 1 IDLE CON STATIC L3270B 3277 04000005 0 0 0 0 1 IDLE CON STATIC L3270C 3277 08000002 46 46 46 0 82 CON STATIC L3270D 3277 04000006 2 0 0 0 8 IDLE CON STATIC *94307/145750* Explanation: The nodes L3270A through L3270D are logged on to IMS.
Entry ET:
/OPNDST NODE DT327002 USER IMSUS01 MODE LU032NT4 USERD DFSUSER UDATA= IMSPW01.
Response ET:
DFS058I 11:07:48 OPNDST COMMAND COMPLETED
Explanation: A session with dynamic node DT327002 is established by using mode table LU032NT4. User IMS01 is signed on to the node using user descriptor DFSUSER, username IMSUS01, and password IMSPW01.
Entry ET:
/OPNDST NODE DTSLU201 USER IMSUS01 MODE SLU2MOD1 USERD DFSUSER LOGOND DFSSLU2 UDATA=IMSPW01.
Response ET:
DFS058I 11:07:48 OPNDST COMMAND COMPLETED
Explanation: DTSLU201 is logged on. A session with dynamic node DTSLU201 is established by using logon descriptor DFSSLU2 (type SLU2), and mode table SLU2MOD1. Dynamic user IMSUS01 is signed on to the node using user descriptor DFSUSER and password IMSPW01.
Entry ET:
/OPNDST NODE WEST-EAST
Response ET:
DFS058I OPNDST COMMAND COMPLETED
Response RT:
DFS3650 TERMINAL CONNECTED TO IMS XXXXXXXX
Explanation: The nodes, WEST through EAST, are logged on to IMS.
The following set of commands illustrate the use of the MODE keyword on the /OPNDST command.
Entry ET:
/DIS NODE LUTYPEP1 MODE
Response ET:
NODE-USR TYPE DEF MODETBL ACT MODETBL LUTYPEP1 SLUP DEFRESP *90179/100206*
Explanation: DEFRESP is the mode table name defined for node LUTYPEP1 at system definition. The session is not active so the ACT MODETBL field is blank.
Entry ET:
/OPN NODE LUTYPEP1.
Response ET:
DFS058I OPNDST COMMAND COMPLETED
Entry ET:
/DIS NODE LUTYPEP1 MODE
Response ET:
NODE-USR TYPE DEF MODETBL ACT MODETBL LUTYPEP1 SLUP DEFRESP DEFRESP *90179/100508*
Explanation: A mode table name was not specified with the /OPNDST command so the default value defined at system definition was used to initiate the session.
Entry ET:
/CLS NODE LUTYPEP1
Response ET:
DFS058I CLSDST COMMAND COMPLETED
Entry ET:
/DIS NODE LUTYPEP1 MODE
Response ET:
NODE-USR TYPE DEF MODETBL ACT MODETBL LUTYPEP1 SLUP DEFRESP *90179/100630*
Explanation: Active mode table name displays as blank at normal session termination.
Entry ET:
/OPN NODE LUTYPEP1 MODE ALPHA.
Response ET:
DFS058I OPNDST COMMAND COMPLETED
Entry ET:
/DIS NODE LUTYPEP1 MODE
Response ET:
NODE-USR TYPE DEF MODETBL ACT MODETBL LUTYPEP1 SLUP DEFRESP ALPHA *90179/100805*
Explanation: The mode table name specified with the /OPNDST command (ALPHA) is used to initiate the session. The default value specified at system definition (DEFRESP) is overridden by the /OPNDST command.