IMS Version 9

/OPNDST

Format

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.

Read syntax diagramSkip visual syntax diagram                        .---------------.
                        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:

Read syntax diagramSkip visual syntax diagram>>-+-/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.

Read syntax diagramSkip visual syntax diagram>>-+-/OPNDST-+--NODE--nodename--USER--username------------------>
   '-/OPN----'

>--+------------+--+----------------+--+---+-------------------><
   '-ID--idname-'  '-MODE--modename-'  '-Q-'

Environments and Keywords

Table 85 lists the environments (DB/DC, DBCTL, and DCCTL) from which the command and keywords can be issued.

Table 85. Valid Environments for the /OPNDST Command and Keywords
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

Usage

/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.

ID
Is applicable only if the USER keyword is specified and the node is a parallel session ISC node. ID identifies the other system half-session qualifier. ID must not be specified for a single session ISC node. ID idname must be specified to open ISC nodes defined with users. The ID idname is passed to the other half-session with the session initiation request. If the other system is another IMS system, idname is the name of an ISC user in that system.
LOGOND
Indicates the logon descriptor used for session establishment. LOGOND is supported only for dynamic non-ISC nodes. The logon descriptor can also be provided through the logon exit.
MODE
Identifies the LOGON MODE table entry that VTAM must use and can determine operating characteristics for certain VTAM terminals. If a list of node names is given, the MODE keyword is applied to each of them. The command checks whether each node has been defined to accept IMS initiated connections. If the node was defined as NOPNDST, the /OPNDST command accepts all the nodes except the node defined as NOPNDST.
NODE
Specifies the VTAM node with which IMS will initiate a session.

/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:

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.

Q
Causes IMS to request VTAM to queue SIMLOGON requests for VTAM/SNA-supported terminals.

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.

UDATA
Indicates the user data used with the signon.

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.

USER
Identifies the logical terminal user to be allocated to the half-session to be created for ISC node nodename. For dynamic non-ISC users, it specifies the user ID to be signed on to the dynamic node nodename.

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.

USERD
Specifies the user descriptor to be used with the signon. It is valid only if the USER keyword and parameter are specified. USERD is only supported for dynamic users and is only valid for dynamic non-ISC nodes. The user descriptor can also be provided through the logon or signon exits.

Examples

Example 1 for /OPNDST Command

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.

Example 2 for /OPNDST Command

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.

Example 3 for /OPNDST Command

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.

Example 4 for /OPNDST Command

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.

Example 5 for /OPNDST Command

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.

Go to the previous page Go to the next page

IBM Confidential

Downloads | Library | Support | Support Policy | Terms of use | Feedback
Copyright: IBM Corporation 1974, 2004 Copyright IBM Corporation 1974, 2004  timestamp Last updated: March, 2004