The START command
This section shows the format of the START command that is used to schedule remote IMS transactions. Note that no interval control is possible (although it is not an error to specify INTERVAL(0)) and that the NOCHECK and PROTECT options must be specified.
EXEC CICS START TRANSID(name)
[SYSID(name)]
[FROM(data-area) LENGTH(value)]
[TERMID(name)]
[RTRANSID(name)]
[RTERMID(name)]
NOCHECK
PROTECT
[FMH]
- TRANSID(name)
- Specifies the name of the IMS editor that is to be initiated to
process the message. It must be an alias (not exceeding four
characters)
of ISCEDT, or an MFS MID name.
Alternatively, it can name the installed definition of a “remote” transaction. In this case, the SYSID option is not used. The definition of the remote transaction must name the required IMS editor in the RMTNAME option, which can be up to eight characters long.
- SYSID(name)
- Specifies the name of the remote IMS system. This is the name of the CONNECTION resource that defines the link to the remote system. You need this option only if you are required to name the remote system explicitly.
- FROM(data-area)
- Specifies the data that is to be sent. The format of the data (VLVB or chain of RUs) must match the format specified in the RECORDFORMAT attribute of the CONNECTION resource that defines the remote IMS system (see Defining connections to remote systems).
- LENGTH(value)
- Specifies, as a halfword binary value, the length of the data specified in the FROM option.
- TERMID(name)
- Specifies the primary resource name that is to be assigned to
the remote process. For IMS, it is a transaction code or an LTERM
name.
If this option is omitted, you must specify the transaction code or the LTERM name in the first eight characters of the data named in the FROM option. You must use this method if the name exceeds four characters (the CICS limit for the TERMID option) or if IMS password processing is required.
- RTRANSID(name)
- Specifies the name of the transaction that is to be invoked when IMS returns a reply to CICS. The name must not exceed four characters in length.
- RTERMID(name)
- Specifies the name of the terminal that is to be attached to the transaction specified in the RTRANSID option when it is invoked. The name must not exceed four characters in length.
- NOCHECK
- This option is mandatory.
- PROTECT
- Specifies that the remote IMS transaction must not be scheduled until the local CICS transaction has taken a syncpoint. PROTECT is mandatory.
- FMH
- Specifies that the user data to be passed to the started task contains function management headers. This option is not normally used.