Customization Information › The Command Exit › Register 1 Settings

Register 1 Settings

Register 1 points to a list of addresses. The following list describes what is contained in each address.

• First Address

  The first address in the parameter list points to the reply buffer.

  The format of the reply buffer is a halfword containing the length of the reply, followed by the reply. The reply can be 1 - 256 bytes long.

  If the command exit updates the reply buffer, the length of the reply is placed in the halfword pointed to by the reply buffer address. The reply is placed after the halfword containing the length and is limited to 256 bytes.

• Second Address

  The second address in the parameter list points to a 256-byte temporary work area.

• Third Address

  The third address in the parameter list points to the full eight-character command name if the command was one of the CA SYSVIEW primary commands.

  For example: A user has a synonym of LOG for the SYSLOG command and issues the LOG command, then this parameter contains the characters SYSLOG.

  If the command entered is a subcommand of the active command, the parameter contains the full eight-character subcommand name.

  If the command entered is an unknown command, the contents of this parameter are unpredictable.

• Fourth Address

  The fourth address in the parameter list points to the parameters entered with the command.

  The first halfword contains the length of the parameters. The parameters follow the halfword.

• Fifth Address

  The fifth address in the parameter list points to the default parameters for a command when the following conditions are true:

  • If the command was one of the CA SYSVIEW primary commands
  • If there are any default parameters

  The format of the default parameters is a halfword containing the length of the parameters, followed by the parameters. If there are no default parameters, the length field contains 0.

  Users define default parameters in their profiles.

• Sixth Address

  The sixth address in the parameter list points to the 8-byte user ID of the user who issued the command.

• Seventh Address

  The address in the seventh parameter points to a byte describing the application where CA SYSVIEW is running. The bits in the byte have the meanings shown in the following table:

• Eighth Address

  The eighth address in the parameter list points to a 4-byte area. This area can be used to save the address of storage acquired by the command exit. This 4-byte area is cleared to binary zeros before calling the exit for the first-time.

• Ninth Address

  The ninth address in the parameter list points to a fixed-length mask character.

• Tenth Address

  The tenth address in the parameter list points to a variable-length mask character.