STACKDUMP

Syntax

             CA           I16V      I16V   I32
  STACKDUMP (formaldesig, idnumber, flags, selec);

              CA           I16V      I16V   I32
  STACKDUMP' (formaldesig, idnumber, flags, selec);

Parameters

formaldesig

character array (optional)

Passes the file name of a new output file to be opened. The name is terminated by any nonalphanumeric character except a slash (/) or a period (.). The same restrictions for the formaldesig parameter in the FOPEN intrinsic apply to this parameter.

(CM: SPL language only) If the secondary entry point, STACKDUMP', is used, the first byte of formaldesig contains the file number that was successfully opened prior to the call to STACKDUMP'. In this case, the file is not closed before returning to the calling program. When a file number is passed, the record length must be between 64 bytes and 512 bytes and write access must be allowed for the file.

Default: Dump is sent to $STDLIST.

idnumber

16-bit signed integer by value (optional)

If the intrinsic fails due to a file system error, the file system specific error number of the failure is returned here. Any value passed into the intrinsic through this parameter is ignored.

flags

16-bit unsigned integer by value (optional)

This parameter is provided for compatibility with MPE V/E. If it is present, it is ignored and has no effect.

selec

32-bit integer array by reference (optional)

This parameter is provided for compatibility with MPE V/E. If it is present in the intrinsic call, it is ignored and has no effect.

Condition Codes

Related Information