Invoking System Tasks from Programs › Invoking the SIGNON Task from Programs › Parameters

Parameters

The #LINK statement to RHDCSNON must include the following parameter list:

Parameter 1 (18-bytes)

Specifies the user ID. The user ID is left-justified and padded on the right with blanks.

Parameter 2 (8-bytes)

Specifies the password. The password is left-justified and padded on the right with blanks. For externally secured signons, this value can alternatively be a PassTicket. PassTickets are short-term substitutes for passwords which are targeted to a specific application.

Note: For more information on PassTickets, see the CA IDMS Security Administration Guide.

Parameter 3 (aligned halfword)

Specifies the return code. On return from RHDCSNON, the return code parameter can contain one of the following values:

0

Specifies the signon was successful.

4

Specifies the user is already signed on to another terminal, and multiple signons are disallowed.

8

Specifies the user ID was not authorized.

12

Specifies the password is invalid.

16

Specifies the user ID is blank (format error).

20

Specifies an error occurred when processing the dictionary.

24

Specifies the signon was stopped by the signon user exit.