Start CICS User (STRCICSUSR)

The start CICS user (STRCICSUSR) command starts a CICS user shell associated with an active CICS control region for the user who initiated this command. The command also specifies whether a CICS transaction is to be initiated when the CICS user shell has been started.

Parameters

Control region (CTLRGN)

The name of the CICS control region with which the CICS user shell will be associated. The name of the CICS control region is also known as the CICS system ID.

• control-region: The length is four characters. The first character must be alphabetic, or one of the special characters, $, @, or #. The remaining characters can be alphanumeric or $, @, or #.

Transaction ID (TRANID)

The name of the CICS transaction identifier used to initiate a CICS program identifier defined in the CICS program processing table.

The possible TRANID values are:

• *NONE: The default CICS screen (which is blank) is displayed, prompting the CICS user to enter the CICS four-character transaction identifier.

  When the CICS transaction is completed, the CICS user shell will stay active, waiting for the next transaction from the user. This process is known as a multi-shot CICS transaction environment.

• *DATA: Specifies that the first four characters of the DATA parameter are used as the CICS transaction identifier, to be the first transaction. This too is a multi-shot CICS transaction environment, because the shell remains active after the initial transaction is completed.
• transaction-id: The transaction identifier may have a maximum length of 4 characters. The first character must be alphabetic, or one of the special characters $, @, or #. The remaining characters can be alphanumeric or one of the special characters $, @, or #. Use of this value means that when this CICS transaction is completed, the CICS user shell returns to the point at which the STRCICSUSR command was entered, and no other transaction is executed. This process is known as a single-shot transaction environment.

Initial TIOA data (DATA)

Indicates the data that is to be used to prime the CICS terminal input/output area (TIOA) for the first RECEIVE command.

The possible DATA values are:

• *NONE: No data is passed to the CICS transaction.
• initial-TIOA-data: Can be up to 3000 characters. The following restrictions apply to this value:
  • If the first characters equal *CICS, the results will be unpredictable.
  • If TRANID(*DATA) is specified, the first four characters will be taken as the transaction identifier.

Examples

Error messages