Operating command result data file

An operating command result data file stores the data returned to the UAP as the command execution result when using the operating command simulator. A single file contains one data item.

Organization of this subsection: (1) File structure; (2) File contents; (3) Notes

(1) File structure

(2) File contents

Item		Position	Length (bytes)	Contents
Header	Operating command result code	0	4	Result code value set in the stat argument of the dc_adm_call_command function
	Character string length for standard output	4	4	Length of character strings (including null characters) output to standard output (0-2147483647)
	Character string length for standard error output	8	4	Length of character strings (including null characters) output to standard error output (0-2147483647)
Character string for standard output		12	n	Value set in the outmsg argument of the dc_adm_call_command function. (Includes the final null character. If no null characters are added, the last character is replaced with a null character.) The specified value is ignored when zero is specified as the character string length for standard output.
Character string for standard error output		--	n	Value set in the errmsg argument of the dc_adm_call_command function. (Includes the final null character. If no null characters are added, the last character is replaced with a null character.) The specified value is ignored when zero is specified as the character string length for standard error output.

Legend:: --: Not applicable

(3) Notes

An operating command result data file for the online tester cannot be used.
Add a null character at the end of a standard output string and a standard error output string. If no null character is added for such strings, the last character in the string is replaced by a null character. If you specify 0 as the string length, the character string is ignored even if it is specified.
Do not use a plus sign (+) in the file name. Also, do not use ps or end as the file name.
When issuing operating commands by SEND statement in a DML, specify the data part as follows:

Character string length for standard output:

Specify 0.

Character string length for standard error output:

Specify 0 (when standard error output is not available).

11.2.7 Operating command result data file

(1) File structure

(2) File contents

(3) Notes