HPCICOMMAND

Syntax

               CA        I16       I16      I16V
  HPCICOMMAND (cmdimage, cmderror, parmnum, msglevel);

Parameters

cmdimage

character array (required)

Passes an ASCII string of <=511 characters consisting of a command and parameters, terminated by a carriage return. The carriage return character (%15) must be the last character of the command string. Do not include a prompt character in this string.

cmderror

16-bit signed integer by reference (required)

Returns any error code set by the last executed command. When the CI displays multiple errors for a single command, cmderr contains only the last error number displayed.

• If cmderror is zero, no error occurred.

• If cmderror is negative, a warning was detected.

This is the same error that would be returned by the command interpreter if cmdimage were executed interactively or in batch. The error message can be found in message set two of CATALOG.PUB.SYS.

Remote commands executed through the COMMAND or HPCICOMMAND intrinsics may not return a meaningful error status.

parmnum

16-bit signed integer by reference (optional)

Returns a number indicating the error:

• If parmnum is positive, it is a file system error number and cmderror is non-zero.

• If parmnum is negative, it is the column number where the error occurred and cmderror is non-zero. (The command interpreter (CI) prints a caret there.)

• If parmnum is zero, then no additional error-related data is available.

NOTE: Check the cmderror parameter to verify if cmdimage succeeded. The parmnum may provide additional information.

msglevel

16-bit signed integer by value (optional)

Passes one of the following values, indicating how to handle error and warning messages:

Value	Meaning
0	All error/warning messages will be printed to $STDLIST (Default)
1	All CI error messages will be printed to $STDLIST; warning messages will be suppressed
2	No error/warning messages will be printed to $STDLIST.

If a value other than 0, 1, or 2 is specified, msglevel defaults to 0 and CIWARN 9007 (Invalid message level - expected 0, 1, 2) is sent to $STDLIST.

HPCICOMMAND prints a caret if the CI does, when given the same cmdimage parameter and msglevel < 2.

Operation Notes

   ABORT      DO         JOB        REDO
   BYE        EOD        LISTREDO   RESUME
   CHGROUP    EOJ        MOUNT      RJE
   DATA       EXIT       MRJE       SETCATALOG
   DISMOUNT   HELLO      NRJE       VSUSER

Related Information