SECCHK command (X'106E')

When security checking is active for the IMS target server, the SECCHK command must be preceded by the ACCSEC command.

Parameters

DSSHDR

The 6-byte header that contains information about the data stream structure (DSS).

LL

The length specified as a 2-byte binary integer. This length includes LL and CP.

CP

X'106E', the 2-byte codepoint of the SECCHK command.

SECMEC

A required parameter that specifies the security mechanism agreed upon by the source server and the target server. For IMS, specify USRIDPWD.

The security mechanism is negotiated between the source server and the target server by using the ACCSEC command and the ACCSECRD reply object.

USRID

A required, variable-length parameter that specifies the user ID of the source application program as a character string. The length can be from 1 to 255 characters.

PASSWORD

A required, variable-length parameter that specifies the password of the source application program as a character string. The length can be from 1 to 255 characters.

If a RACF PassTicket is used to authenticate user access from an IMS Connect client to IMS DB, this parameter specifies the PassTicket.

Usage

IMS uses a user ID and password to check security; therefore the value of the SECMEC parameter specifies the DDM USRIDPWD security mechanism.

If no errors occur during the processing of the SECCHK command, the IMS target server returns the SECCHKRM reply message to indicate the acceptability of the security information.

The SECCHK command must be preceded by the ACCSEC command.

Chained command objects

No command objects can be chained to the SECCHK command.

Positive reply messages

In response to the SECCHK command, the IMS target DDM server returns to the source server the following positive reply message:

SECCHKRM (X'1219')

Security check reply message.

Error reply messages

In response to the SECCHK command, the IMS target DDM server can return to the source DDM server the following error reply messages: