Enhancements to Existing Features › Components › REXX Environment

REXX Environment

The CA SYSVIEW REXX function has been enhanced.

REXX Address Environment

The CA SYSVIEW REXX services have been enhanced to allow a host environment and module to be specified.

ADDRESS LINK GSVXRXAA <envname> <modname> <subname>

<envname>

(Optional) The host command environment name to be added to the REXX host command environment table.

Default: &G$HCEnvName

If specified, the value must be from 1 to 8 alpha, national, or numeric characters. The lowercase characters are translated to uppercase.

If an environment name is not specified, the environments SYSVIEW and SYSVIEWE are both created.

<modname>

(Optional) The name of the module to be invoked for "ADDRESS <envname>".

Default: GSVXAPIE

If specified, the value must follow standard PDS member name rules.

<subname>

The name of the module that the <modname> parameter attaches. This parameter is optional. The default is GSVXAPID. If specified, the value must follow standard PDS member name rules.

• Return codes from this routine:
  • 00 - The requested entry was added to the host command environment table or was already in the table.
  • 04 - Too many parameters were specified. Only three are allowed.
  • 08 - A required parameter was omitted. This return code is not currently used and should not occur.
  • 12 - The maximum length of a parameter was exceeded. The <envname>, <modname>, and <subname> parameters all have a maximum length of 8 bytes.
  • 16 - An invalid parameter value. The <envname>, <modname>, or <subname> parameter contained invalid characters.
  • 20 - IRXSUBCM error. A message that explains the error is also issued.
  • 28 - IRXSUBCM error. A language processor environment could not be located.
  • 32 - IRXSUBCM error. The parameter list is not valid. The parameter list contains either too few or too many parameters. Or the high-order bit of the last address in the parameter list is not set to 1 to indicate the end of the parameter list.
• To delete a host command environment table entry use GSVXRXAD. This module does not delete an entry whose token is not blanks or nulls. To delete one of these entries use GSVXRXAP (see the following bullet).
• To purge a host command environment table entry use GSVXRXAP. This module does not delete an entry regardless of the contents of the token.

REXX Functions Added

The CA SYSVIEW REXX function has been enhanced to include the following new commands:

• TESTCMD - The TESTCMD function tests the string to see if it is a valid command name and, if so, can the command be executed. The string is supplied as an argument.