3.6.8 Output items for operation information in CSV format

The following table lists and describes the output items (columns) for operation information in CSV format.

Table 3‒3: Output items (columns) for operation information
No.	Item name	Description
1	`EvtName`	Name indicating the type of operation information (record): `adshStart`: Start of `adshexec` command execution `envVar`: Environment variable `command`: Command `message`: Message `stepStart`: Start of job step execution `stepEnd`: End of job step execution `stepSkip`: Skipped job step execution `jobEnd`: End of job execution
2	`RecTZ`	Time zone in effect when the `adshevtout` command was executed.^# This is the time zone that is used to represent the date and time information in the operation information.
3	`RecTime`	Date and time the operation information was recorded^#
4	`PhysicalHostName`	Physical host name
5	`LogicalHostName`	Logical host name. If a logical host is not used, the null character string is set.
6	`OsName`	OS name. One of the following character strings: `Windows` `Linux` `AIX` `HP-UX` `Solaris`
7	`Jp1ajsService`	JP1/AJS scheduler service name. This is the value set in the `AJS_AJSCONF` environment variable by JP1/AJS. This information is output when the job was started from JP1/AJS.
8	`Jp1ajsRootJobnet`	JP1/AJS's root jobnet name. This is the value set in the `AJSNETNAME` environment variable by JP1/AJS. This information is output if the job was started from JP1/AJS.
9	`Jp1ajsJobName`	JP1/AJS's job name. This is the value set in the `AJSJOBNAME` environment variable by JP1/AJS. This information is output when the job was started from JP1/AJS.
10	`Jp1ajsExecId`	JP1/AJS's job execution ID. This is the value set in the `AJSEXECID` environment variable by JP1/AJS. This information is output when the job was started from JP1/AJS.
11	`Jp1ajsJobId`	JP1/AJS's job number. This is the value set in the `JP1JobID` environment variable by JP1/AJS. This information is output when the job was started from JP1/AJS.
12	`Jp1asJobName`	JP1/Advanced Shell's job name
13	`Jp1asJobId`	JP1/Advanced Shell's job ID
14	`Jp1asJobTime`	`adshexec` command execution start date and time^#
15	`Jp1asJobPid`	Process ID of the `adshexec` command
16	`Jp1asUid`	User ID of the `adshexec` command's process. In Windows, the null character string is set.
17	`Jp1asGid`	Group ID of the `adshexec` command's process. In Windows, the null character string is set.
18	`Jp1asUserName`	User name of the `adshexec` command's process.
19	`Jp1asGroupName`	Group name of the `adshexec` command's process. In Windows, the null character string is set.
20	`Jp1asScriptPath`	Path name of the job definition script^#
21	`Jp1asEnvPath`	Path name of the environment file^#
22	`Jp1asSpoolPath`	Path name of spool directory.^# A spool job's directory name is `job-ID_job-name` once the job has terminated, but this item outputs only `job-ID`.
23	`Jp1asJobLang`	Value of the `LANG` environment variable when the `adshexec` command's execution started.
24	`Jp1asJobEncode`	Character encoding when the `adshexec` command's execution started.^#
25	`RecTZExec`	Time zone in effect when the `adshexec` command was executing.^# This time zone is not used to represent the date and time information in the operation information.
26	`Jp1asJobParentJobName`	Name of the parent job. For a root job, the null character string is set.
27	`Jp1asJobParentJobId`	Job ID of the parent job. For a root job, the null character string is set.
28	`Jp1asJobParentJobTime`	Parent job execution start date and time.^# For a root job, the null character string is set.
29	`Jp1asJobParentJobPid`	Process ID of the parent job. For a root job, the null character string is placed.
30	`Jp1asJobRc`	`adshexec` command's return code
31	`Jp1asJobSig`	Signal number if the `adshexec` command terminated with a signal. If the command did not terminate with a signal, `0` is set. In Windows, the null character string is set.
32	`EnvVar`	Environment variables used when the `adshexec` command started. The format is `environment-variable-name=value`. For details, see (1) Environment variables in the EnvVar item below.
33	`Jp1asScriptLineNo`	Line number in the job definition script. For details, see (2) Line number in the Jp1asScriptLineNo item below.
34	`Jp1asStepSeq`	Job step number. If this is not a step, the null character string is set.
35	`Jp1asStepName`	Job step name. If the job step name is omitted or this is not a step, the null character string is set.
36	`Jp1asStepSkip`	The preceding command or job step's status when the job step was skipped: `normal`: Skipped because the status was normal. `abnormal`: Skipped because an error resulting in termination occurred.
37	`Jp1asStepRc`	Job step's return code.
38	`Jp1asStepSig`	Signal number if the job step terminated with a signal. If the job step did not terminate with a signal, `0` is set. In Windows, the null character string is set.
39	`Jp1asCmdExec`	Command execution mode: `null-character-string`: Foreground execution. `back`: Background execution. For details, see (3) Command execution mode in the Jp1asCmdExec item below.
40	`Jp1asCmdType`	Command type: `assign`: Standard shell command that updates a shell variable. `embStd`: Standard shell command or extended shell command. `embAdsh`: Extended script command. `extCmd`: External command.
41	`Jp1asCmdPath`	Command name. For an external command, the command's path name.^# For details, see (4) Command name and command's path name in the Jp1asCmdPath item below.
42	`Jp1asCmdArg`	Command arguments. The arguments are delimited by the space. These are not the arguments as specified on the command line or in the job definition script, rather they are the character strings obtained by evaluating (expanding) the arguments specified on the command line or in the job definition script and that are passed to the command.
43	`Jp1asLang`	Value of the `LANG` environment variable during command execution
44	`Jp1asCharEncode`	Character encoding during command execution^#
45	`Jp1asCmdStart`	Command execution start date and time^#
46	`Jp1asCmdEnd`	Command execution termination date and time^#
47	`Jp1asCmdElaps`	Duration of command execution. This is the difference between the command's execution start date and time and its termination date and time (microseconds).
48	`Jp1asCmdRc`	Command's return code
49	`Jp1asCmdSig`	Signal number if the command terminated with a signal. If the command did not terminate with a signal, `0` is set. In Windows, the null character string is set.
50	`Jp1asCmdPid`	Process ID of an external command
51	`Jp1asCmdCpuUser`	Command's user CPU time^# (microseconds)
52	`Jp1asCmdCpuSys`	Command's system CPU time^# (microseconds)
53	`Reserved1`	Reserved item (null character string)
54	`Reserved2`	Reserved item (null character string)
55	`Jp1asMsgId`	Message ID
56	`Jp1asMsgText`	Message text
57	`Jp1asMsgLang`	Value of the `LANG` environment variable when the message was output
58	`Jp1asMsgEncode`	Character encoding when the message was output^#

#

The following table explains the output items.

Item	Output contents
End-of-line code	An end-of-line code contained in the value of an item is replaced with a space. Specifically, each of the character codes `LF(0x0A)` and `CR(0x0D)` is replaced with a space (`0x20`). For a new line in Windows, a pair of `CR(0x0D)` and `LF(0x0A)` is replaced with two bytes of spaces (`0x20`).
Date and time	The date and time are represented in the following format `YYYY-MM-DD` `hh:mm:ss.nnn` `YYYY`: Calendar year `MM`: Month `DD`: Date `hh`: Hour `mm`: Minute `ss`: Second `nnn`: Millisecond The date and time when the `adshevtout` command is executed are represented based on the time zone specified in the `TZ` environment variable. If acquisition of date and time information failed due to an error in the time acquisition function at the time the operation information was collected by the `adshexec` command, the date and time are represented as follows: EEEE-EE-EE ee:ee:ee.eee
Time zone	The difference from UTC is indicated in one of the formats shown below. The sign differs from the setting of the `TZ` environment variable. +`hh`:`mm`:`ss` -`hh`:`mm`:`ss` `hh:` Hour `mm:` Minute `ss:` Second If the time difference is 0, the value is `+00:00:00`. Example: The time zone that is nine hours ahead of coordinated universal time (UTC) is `+09:00:00`. If the time zone cannot be converted to the format shown above, the value in this item is `+EE:EE:EE`.
Character encoding	In Windows This is always SJIS regardless of the actual character string encoding used. In Linux, AIX, HP-UX, and Solaris In Japanese, the character encoding determined from the value of the `LANG` environment variable is set as follows: `SJIS`: Shift JIS code `EUC`: Extended Unix Code `UTF8`: UTF-8 In all other cases, the following value is set: `OTHER(LANG-environment-variable-value)`
Path name	Any number of consecutive directory separators in path names are output as is. Consecutive directory separators are not replaced with a single directory separator. For example, if the specified path name is `"C:\\dir"`, `"C:\\dir"` is output.
CPU time	For external commands: CPU time of the process that executed the external command For other commands: The CPU time of the process of `adshexec` that executed the command. This is not the CPU time when each command was executed.

Organization of this subsection

(1) Environment variables in the EnvVar item
(2) Line number in the Jp1asScriptLineNo item
(3) Command execution mode in the Jp1asCmdExec item
(4) Command name and command's path name in the Jp1asCmdPath item

(1) Environment variables in the EnvVar item

The following environment variables are output

The environment variables that were specified at the time the job started are output.
If environment variables are specified in the environment file, the environment variables to which the settings in the environment file have been applied are output.
The environment variables set by the adshexec command are output.
The environment variables deleted by the adshexec command are not output.
Value of the ADSH_JOB_NAME environment variable is the standard job name ADSHxxxxxx (xxxxxx: job ID). This is not the job name specified in #-adsh_job.
The above also apply to child jobs.

To Page Top

(2) Line number in the Jp1asScriptLineNo item

The value of this item is the null character string in the following cases:

A command whose action was specified in the trap command was executed.
The #-adsh_script command was executed.
A command specified by command substitution was executed.

If a function is executed, the line number assigned to the command that is defined in the body of the function is output.

To Page Top

(3) Command execution mode in the Jp1asCmdExec item

If cmd1 | cmd2 | cmd3 is executed, the item value is back because cmd1 and cmd2 are executed in separate processes.

To Page Top

(4) Command name and command's path name in the Jp1asCmdPath item

(a) If the command is executed in another process

If the command is executed in another process, the item value is Another process script as shown in the following example:

Example:

(echo1 a ; echo2 b)
(echo1 a) &
(echo1 a ; echo2 b) &
{ echo1 a ; echo2 b ; } &
{ echo1 a ; echo2 b ; } |&

In the following example, the value of the part { echo1 a ; echo2 b ; } becomes Another process script.

{ echo1 a ; echo2 b ; } | echo3 c

(b) If the command is executed by using a pipe

If cmd1 | cmd2 | cmd3 is executed and cmd1, cmd2, and cmd3 are all external commands, the item values become as follows:

cmd1: command-name(file-name)
cmd2: command-name(file-name)
cmd3: path-name

To Page Top