DEFUSER

DEFUSER command image [routine]

Define a command which calls a user written subroutine in a shareable image.

command

- The command to be defined. An abbreviation may be specified in the form COM(MAND) where COM is the minimum acceptable abbreviation.

image

- The name of the shareable image containing the routine. This must be a logical name if the image is not in SYS$SHARE.

routine

- (optional) The name of the subroutine to be called. This must be a universal symbol of the shareable image. If omitted it defaults to command.

The subroutine should have a single character string parameter in which it will receive the ICL command line parameter string. The string is received as typed, except for the substitution of bracketed expressions.

Typing command causes the shareable image to be activated dynamically (if it is not already loaded), and the subroutine to be called. The subroutine can return an error message to ICL by signalling a VMS condition. This will result in the ICL exception USERERR. The exception text will contain the message associated with the VMS status returned.