Format for CINIT user data parameters

This topic describes the CINIT user data parameters and the syntax rules for them.

For all non-MSC VTAM® terminal types, IMS can receive user data parameters from the following sources:

  • IMS (/OPNDST command)
  • IMS autologon request
  • User logon (such as SNA INITSELF command)
  • Installation Logon exit routine (DFSLGNX0)
  • Signon exit routine (DFSSGNX0)
  • Destination Creation exit routine (DFSINSX0)

User data parameters are optional for migration purposes. However, when a match must be made between the terminal and user for session initiation, user data parameters are required for:

  • ISC parallel session (LU 6.1 architecture)
  • Finance (3601) and SLU P terminals, when used with ETO

All parameters, optional and required, appear in the CINIT user data field and are available to IMS when the VTAM Logon exit routine is scheduled.

During logon and signon processing, IMS performs minimal processing on CINIT user data parameters before calling the Installation Logon exit routine (DFSLGNX0) and the Signon exit routine (DFSSGNX0). If the Logon or Signon exit routines are not supplied, IMS assumes a default user data format.

User data format

The format for the CINIT user data is shown in the following syntax diagram.

Read syntax diagramSkip visual syntax diagramLOGOND=lnameuseridUSERD=unameuserdata

For these parameters, blanks are required and are the only recognized delimiters. Do not use more than one blank to delimit parameters.

Parameters

LOGOND=lname
Specifies logon descriptor name to be used for the terminal attempting to log on to IMS. lname is one to eight bytes in length. The LOGOND and USERD parameters are valid only for Extended Terminal Operation (ETO).
userid
Specifies the 1- to 8-byte user ID of the user logging on to IMS. The userid parameter indicates that the user associated with this ID will also sign on to IMS.
The userid parameter is required for Finance, SLU P, ISC, and output-only devices (such as printers).
Restriction: ISC is restricted to only the user ID that translates to the ISC SUBPOOL name (SNA PHS/SHS qualifier). For ISC parallel sessions, the DFSLGNX0 exit routine receives only the user ID that translates to the ISC subpool name (SNA PHA/SHA qualifier).
USERD=uname
Specifies the 1- to 8-byte user descriptor name to be used to create the user control block structure at signon.
userdata
Specifies additional data for the Signon exit routine (DFSSGNX0) or the Sign On/Off Security exit routine (DFSCSGN0) and security products, such as RACF®. For the exit routines, your installation defines the format of the userdata fields.
For RACF, the format of the userdata is:
userpw
Identifies the 1- to 8-byte user password that is associated with the previously entered userid. No keyword precedes the user password.
GROUP groupname
Identifies groupname as the 1- to 8-byte group name that is associated with the userid parameter. The GROUP keyword and associated parameter are optional.
NEWPW nuserpw
Identifies nuserpw as a new user password that replaces the current password, userpw.

The ETO logon descriptor name, lname, applies to IMS logon processing. All remaining optional parameters, however supplied, are passed to ETO user allocation, signon processing, and the security product, such as RACF. If a security product is used, all parameters not applicable to that product must be deleted before it is called. The parameters can be deleted in the DFSLGNX0, DFSSGNX0, and DFSCSGN0 exit routines.