/START USER command

Without the NODE keyword, USER specifies the ISC user or the dynamic user to start. The USER parameter can be generic where the generic parameter specifies users that already exist.

Subsections:

Environment

The following table lists the environments (DB/DC, DBCTL, and DCCTL) in which you can use the commands and keywords.

Table 1. Valid environments for the /START USER command and keywords
Command / Keywords DB/DC DBCTL DCCTL
/START X X X
USER X   X

Syntax

Read syntax diagramSkip visual syntax diagram/START/STAUSER usernameusername*ALL

Usage notes

The /START USER command applies only to users that are stopped and signed off. The /START USER command also terminates any active conversations before starting the user.

The /START USER command removes the user from MFSTEST mode and exclusive mode. If the USER structure is temporary and the status conditions that caused the creation of the structure have been reset, the temporary user is deleted at the next simple checkpoint.

For ISC users, the user is started and made available for allocation.

For dynamic users, the user is started and made available for signon. If the dynamic user was in either Fast Path input or output response mode, and the Fast Path input or output response mode is reset by the /STOP USER and /START USER commands issued in sequence, IMS writes a X'67D0' Subtype 11 trace log record.

The /START USER command no longer removes the user from test mode, and preset mode. MFSTEST mode can now be associated with the node and with the user. MFSTEST mode (at the user level) and exclusive mode are still reset. The other statuses are no longer significant and therefore not carried across signon or restart.

If global resource information is not kept in Resource Manager, the /START USER command allows a user to signon to the local IMS. If global resource information is kept in Resource Manager, the /START USER command allows a user to signon to any IMS in the IMSplex.

If a user in conversational mode receives the message, DFS058I START COMMAND COMPLETED EXCEPT when a /START USER command is issued, it is possible that the conversation is INUSE by some other process. This is a temporary condition; you can reissue the /START USER command.

Examples

The following is an example of the /START USER command:

Entry ET: 
/DISPLAY USER IMSUS01 IMSUS02
Response ET: 
  USER     ENQCT DEQCT   QCT
  IMSUS01      0     0     0 STOPPED
  IMSUS02      0     0     0 STOPPED
  *91091/111727*
Entry ET: 
R 38,/START USER IMSUS01
Response ET: 
DFS058I 11:19:05 START COMMAND COMPLETED
Entry ET: 
/DISPLAY USER IMSUS01 IMSUS02
Response ET: 
USER     ENQCT DEQCT   QCT
IMSUS01      0     0     0
IMSUS02      0     0     0 STOPPED
*91091/113038*
Entry ET: 
/START USER APPLE*
Response ET: 
DFS3633 11:19:35 GENERIC PARAMETER RESOURCES NOT FOUND, NO ACTION TAKEN