Job Management Partner 1/Automatic Job Management System 3 Command Reference 1

[Contents][Glossary][Index][Back][Next]


ajsprint

Format

ajsprint
     [-F service-name]
     {-a|-c year[/month[/day]]|-d|-f format-indicator|-v}
     [-t format-indicator]
     [-J|-N|-G]
     [-R]
     [-L|-E]
     [-T]
     job-name-or-jobnet-name-or-job-group-name...

Description

Outputs definitions of a unit to the standard output file.

Execution privileges

You must have any of the following JP1 privileges:

Arguments

-F service-name

Specify the name of the target scheduler service.

You can specify a character string of 1 to 30 bytes.

-a

Specify this option to output the unit definition information of the specified unit and its subordinate units in the format available for the ajsdefine command.

With this option specified, you cannot specify the root job group "/" as its argument.

You cannot specify this option with the -t option.

You can use the AJSPRINTNETSCHPRF environment setting parameter to specify either of the following output formats when outputting unit definition information for a nested jobnet having a schedule rule with a specification depending on the schedule for the upper-level jobnet:

For details about how to set the AJSPRINTNETSCHPRF environment setting parameter, see 2.2 Setting up the scheduler service environment in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 2.

-c year[/month[/day]]

Specify the date when you want to output calendar information (open or closed day).

You can specify this option with the -t option, but cannot specify it with the -J, -N, -L, -E, or -T option.

You can select one of the following output formats. (Also see Example 1 later.)

If you specify this option, you can specify only a job group name as the argument for the unit. (If you specify a job or jobnet name, no characters are output.)

If you define a job group under another job group, the calendar information of the job group you defined and the calendar information of all upper-level job groups are merged, as shown in the example below.

Example:
[Figure]

-d

Outputs the calendar information parameter needed to deliver calendar information.

If you specify this option, you can specify only a job group name as the argument for the unit. (If you specify a job or jobnet name, no characters are output.) You can specify the root job group "/" as well.

Output information is the unit definition parameters for the open and closed days. By outputting the information in a file, you can specify the file as the calendar information file in the -df option in the ajscalendar command. For details about their format, see 4.1 Creating a unit definition file in the manual Job Management Partner 1/Automatic Job Management System 3 Command Reference 2.

You cannot specify this option with the -J, -N, -L, -E, -T or -t option.

-f format-indicator

Outputs the information specified by the format indicator.

Specify the format indicator by % followed by a one- or two-byte string of alphabetic characters. For details about the format indicator, see Additional informations later.

Characters are output as specified, except for the format indicator enclosed in double quotation marks (").

You can specify this option with the -t option.

-v

Searches for units that are placed in a particular directory and are using macro variables. The option thus outputs three items of information about such units, if any, in list form. The information refers to the full name of the unit, the definition item name (the unit definition parameter name), and the macro variable name in the definition information. The three items of information correspond to a single line of output data. If two or more of the same item are found, there will be as many outputs as there are lines. Even when one definition item in a single unit has several macro variables defined, one line of data is divided and output on several lines.

The output format is shown below (also see Example 3 later in this section):

If the units under the particular directory have no units using macro variables, then nothing is output and the command terminates normally.

You cannot specify this option together with the -a, -c, -d, -f, or -t option.

-t format-indicator

Outputs the information specified by the format indicator to the title row.

Specify the format indicator by % followed by a one- or two-byte string of alphabetic characters. For details about the format indicator, see Additional informations later.

Characters are output as specified, except for the format indicator enclosed in double quotation marks (").

You can specify this option with the -c and -f options, but cannot specify this option with the -a option.

-J

Outputs job definitions.

You cannot specify this option with the -c, -d, or -T option.

-N

Outputs jobnet definitions.

You cannot specify this option with the -c or -d option.

-G

Outputs job group definitions.

You cannot specify this option with the -L, -E, and/or -T option.

-R

Outputs the definitions of all the job groups, jobnets, and jobs contained in the specified unit. The items are output repeatedly on a layer-by-layer basis.

If you specify this option with the -L, -E, and/or -T options, the system outputs the definitions of the unit according to the specification of each option.

It is recommended that you avoid specifying this option together with the -a option. If you specify this option together with the -a option, an attempt to specify the output result in the unit definition information in the ajsdefine command may fail to define the unit correctly.

-L

Outputs definitions of a jobnet not registered for execution.

You cannot specify this option with the -c, -d, or -G option.

-E

Outputs definitions of a jobnet registered for execution.

You cannot specify this option with the -c, -d, or -G option.

-T

Outputs definitions of the root jobnet.

You cannot specify this option with the -c, -d, -J, or -G option.

job-name-or-jobnet-name-or-job-group-name

Specify the name of the job, jobnet, or job group that you want to output definitions.

You can specify a character string of 1 to 930 bytes.

You can specify more than one job, jobnet, or job group names. If you set the -c and -d options, however, you can specify only a job group name.

With the -a option specified, you cannot specify the root job group "/" as its argument.

With the -d option specified, you can specify the root job group "/" as its argument.

You can specify a logical host name as a job, jobnet or job group name. You cannot specify an execution ID.

Notes

Return values

0 Normal end
Multiple of 4 within the range from 4 to 124 Abnormal end

Additional informations

 

Table 2-11 Format indicators for unit output

Format indicator Output information Unit type abbreviations#3
%JN#1 Full name of a unit
Character string of up to 930 bytes
mg, g, mn, rc, n, rm, j, pj, qj, jdj, orj, cmsj, evsj, evwj, flwj, lfwj, mlsj, mlwj, mqsj, mqwj, mssj, mswj, ntwj, pwlj, pwrj, tmwj, nc
%jn#1 unit-name
Character string of up to 30 bytes
mg, g, mn, rc, n, rm, j, pj, qj, jdj, orj, cmsj, evsj, evwj, flwj, lfwj, mlsj, mlwj, mqsj, mqwj, mssj, mswj, ntwj, pwlj, pwrj, tmwj, nc
%ap#1 Character string set for AJSCONF= or AJSPATH=
Character string specified with %JN except the part that follows the right-most slash (/)
mg, g, mn, rc, n, rm, j, pj, qj, jdj, orj, cmsj, evsj, evwj, flwj, lfwj, mlsj, mlwj, mqsj, mqwj, mssj, mswj, ntwj, pwlj, pwrj, tmwj, nc
%TY#1 Unit type
mgroup: Manager job group
group: Job group
mnet: Manager jobnet
condn: Start condition (.CONDITION)
net: Jobnet
rnet: Jobnet for recovery
rmnet: Remote jobnet
rrnet: Remote jobnet for recovery
job: UNIX job
rjob: UNIX job for recovery
pjob: PC job
rpjob: PC job for recovery
qjob: QUEUE job
rqjob: QUEUE job for recovery
jdjob: Judgment job
rjdjob: Judgment job for recovery
orjob: OR job
rorjob: OR job for recovery
cmsjb: OpenView status report job
rcmsjb: OpenView status report job for recovery
evwjb: JP1 event reception monitoring job
revwjb: JP1 event reception monitoring job for recovery
flwjb: File monitoring job
rflwjb: File monitoring job for recovery
mlwjb: Email reception monitoring job
rmlwjb: Email reception monitoring job for recovery
mqwjb: Message queue reception monitoring job
rmqwjb: Message queue reception monitoring job for recovery
mswjb: MSMQ reception monitoring job
rmswjb: MSMQ reception monitoring job for recovery
lfwjb: Log file monitoring job
rlfwjb: Log file monitoring job for recovery
ntwjb: Windows event-log monitoring job
rntwjb: Windows event-log monitoring job for recovery
tmwjb: Execution interval control job
rtmwjb: Execution interval control job for recovery
evsjb: JP1 event sending job
revsjb: JP1 event sending job for recovery
mlsjb: Email sending job
rmlsjb: Email sending job for recovery
mqsjb: Message queue sending job
rmqsjb: Message queue sending job for recovery
mssjb: MSMQ sending job
rmssjb: MSMQ sending job for recovery
pwljb: Local power control job
rpwljb: Local power control job for recovery
pwrjb: Remote power control job
rpwrjb: Remote power control job for recovery
cuujb: Custom UNIX job
rcuujb: Custom UNIX job for recovery
cupjb: Custom PC job
rcupjb: Custom PC job for recovery
mg, g, mn, rc, n, rm, j, pj, qj, jdj, orj, cmsj, evsj, evwj, flwj, lfwj, mlsj, mlwj, mqsj, mqwj, mssj, mswj, ntwj, pwlj, pwrj, tmwj, nc
%ow#1 Owner name
Character string of up to 63 bytes. By default, no characters are output.
mg, g, mn, rc, n, rm, j, pj, qj, jdj, orj, cmsj, evsj, evwj, flwj, lfwj, mlsj, mlwj, mqsj, mqwj, mssj, mswj, ntwj, pwlj, pwrj, tmwj, nc
%gr#1 Group name
Character string of up to 63 bytes. By default, no characters are output.
mg, g, mn, rc, n, rm, j, pj, qj, jdj, orj, cmsj, evsj, evwj, flwj, lfwj, mlsj, mlwj, mqsj, mqwj, mssj, mswj, ntwj, pwlj, pwrj, tmwj, nc
%ud#1 Last updated time#2 mg, g, mn, rc, n, rm, j, pj, qj, jdj, orj, cmsj, evsj, evwj, flwj, lfwj, mlsj, mlwj, mqsj, mqwj, mssj, mswj, ntwj, pwlj, pwrj, tmwj, nc
%cm Comment
Character string of up to 80 bytes. By default, no characters are output.
mg, g, mn, n, rm, j, pj, qj, jdj, cmsj, evsj, evwj, flwj, lfwj, mlsj, mlwj, mqsj, mqwj, mssj, mswj, ntwj, pwlj, pwrj, tmwj, nc
%mh Manager host name
Character string of up to 255 bytes. By default, no characters are output.
mg, mn
%mu Manager unit name
Character string of up to 930 bytes. By default, no characters are output.
mg, mn
%en Name of a unit contained in the specified unit
Character string of up to 30 bytes
g, n, rm
%eN Name of a unit that has type symbols and that is contained in the specified unit
Character string of up to 35 bytes including symbols. The symbols at both edges indicate a type.
<job-group-name>
(jobnet-name)
(remote-jobnet-name)R
[UNIX-job-name]
<manager-job-group-name>M
(manager-jobnet-name)M
{QUEUE-job-name}
[PC-job-name]P
!start-conditional-jobnet-name!
[judgment-job-name]J
[OR-job-name]O
[JP1-event-reception-monitoring-job-name]E
[file-monitoring-job-name]F
[email-reception-monitoring-job-name]M
[message-queue-reception-monitoring-job-name]Q
[MSMQ-reception-monitoring-job-name]S
[log-file-monitoring-job-name]L
[Windows-event-log-monitoring-job-name]N
[execution-interval-control-job-name]T
[JP1-event-sending-job-name]e
[email-sending-job-name]m
[message-queue-sending-job-name]q
[MSMQ-sending-job-name]s
[HP-NNM-status-report-job-name]C
[local-power-control-job-name]W
[remote-power-control-job-name]w
[custom-UNIX-job-name]U
[custom-PC-job-name]u
(jobnet-connector-name)C
For a recovery jobnet or job, use double brackets.
Example:
[[recovery-UNIX-job-name]]
g, rc, n, rm
%Ce Whether to enable linkage of root jobnet execution order control between scheduler services
y: Linkage between scheduler services is enabled.
n: Linkage between scheduler services is disabled.
g, n, nc
%Ch Connection host name
Character string of no more than 255 bytes. By default, no characters are output.
g, n, nc
%Cs Connection service name
Character string of no more than 30 bytes. By default, no characters are output.
g, n, nc
%et Type of a unit contained in the specified unit
See %TY.
g, n, rm
%eH Horizontal display position of a unit contained in the specified unit
0 to 16,000 pixels
g, n, rm
%eV Vertical display position of a unit contained in the specified unit
0 to 10,000 pixels
g, n, rm
%sH How many units contained in the specified unit are to be displayed horizontally
1 to 100
g, rc, n, rm
%sV How many units contained in the specified unit are to be displayed vertically
1 to 100
g, rc, n, rm
%op Open day (Specify a particular day.)#2 g
%cl Closed day (Specify a particular day.)#2 g
%w0 to %w6 Standard-week value
%w0: Sunday
%w1: Monday
%w2: Tuesday
%w3: Wednesday
%w4: Thursday
%w5: Friday
%w6: Saturday
o: Open day
x: Closed day
-: None
g
%sd Base date
1 to 31: day
xx:n: Day of the week (xx is su, mo, tu, we, th, fr or sa) and week (n is 1 to 5)
None
g
%md Base month
this: Current month
next: Next month
-: None
g
%st Base time
hh:mm : Hours (hh is 0 to 23 hours, and mm is 0 to 59 minutes.)
**:**: None
g
%Sd Date when the jobnet execution is started#2 n, rm
%St Time when the jobnet execution is started#2 n, rm
%sy Time when the jobnet start is delayed#2 n, rm
%ey Time when the jobnet end is delayed#2 n, rm
%ln Link number
N,n: N indicates a rule number (1 to 144) when multiple schedules are defined. n indicates a link number (1 to 144). Nothing is output if the rule number is the same as the link number.
-,-: None (The related jobnet does not have any link number to be output).
n, rm
%cy Processing cycle
N,n,X: N indicates a rule number when multiple schedules are defined (1 to 144). n is the value corresponding to X, being 1 to 31 (year, month, week or day). X indicates the type of a processing cycle, being y, m, w or d.
n,y: Year (n is 1 to 9.)
n,m: Month (n is 1 to 12.)
n,w: Week (n is 1 to 5.)
n,d: Day (n is 1 to 31.)
-,-,-: None
n, rm
%sh Method of substitution
N,XXXX: N indicates a rule number when multiple schedules are defined (1 to 144). XXXX indicates the method of substitution, being before, after, cancel or none.
before: Execute on the previous day
after: Execute on the next day
cancel: Do not execute
none: Execute without shift
n, rm
%hd Maximum number of shift days
N,XX: N indicates a rule number when multiple schedules are defined (1 to 144). XX indicates the maximum number of shift days, being 1 to 31.
n, rm
%Wt Waiting time for an event
{N,t,HH:MM|N,r,MMMM|N,u|N,-}:
N indicates a rule number when multiple schedules are defined (1 to 144). t, r, u and - provide the types of waiting time for an event. HH:MM (HH is hours of 0 to 47, and MM is minutes of 0 to 59) and MMMM (1 to 2,879 minutes) provide waiting time for an event.
t: Absolute time
r: Relative minutes
u: Unlimited
-: None
n, rm
%Wc Number of times the event is awaited
{N,w,n|N,u|N,-}:
N indicates a rule number when multiple schedules are defined (1 to 144). w, n, u and - provide the types of the number of times the event is awaited. n indicates the number of times the event is awaited (0 to 999).
w: Specifies the number of events to be awaited.
u: Specifies an unlimited number of times for waiting.
-: None
n, rm
%Cf Shift information
{N,m,C,c|-}:
N indicates a rule number when multiple schedules are defined (1 to 144). m indicates a shift type, being a, b or n. C indicates shift days, being 1 to 31. c indicates the maximum number of shift days, being 1 to 31. - means none.
b: Execute on an open day preceding the previous day
a: Execute on an open day following the next day
n: None
n, rm
%Ej Name of a jobnet not to be executed concurrently
Character string of up to 30 bytes. By default, no characters are output.
n, rm
%ed Term until the jobnet can be executed#2 n, rm
%rg Number of logs to keep
1 to 99
You can, however, enable the system setting option to output up to 999 generations.
n, rm
%Ni Execution priority of a jobnet
1 to 5. The default is -.
n, rm
%jc Calendar information
Character string of up to 930 bytes. By default, no characters are output.
n, rm
%cd Time-out period for waiting for an event
1day: Waits for one day.
2day: Waits for two days.
unlimited: Waits without any limit.
-: None
n, rm
%de Dependence on the schedule of the upper-level jobnet
yes: Depends.
no: Does not depend.
n, rm
%ms Schedule option
skip: Schedule skip
muti: Multi-schedule
n, rm
%mp Concurrent execution attribute
yes: Permitted
no: Not permitted
n, rm
%ha Hold attribute
yes: Holds
no: Does not hold
ifAbend: Hold if the previous state was abend
ifAbendW: Hold if the previous state was warning
n, rm, j, pj, qj, jdj, cj, cpj, cmsj, evsj, evwj, flwj, lfwj, mlsj, mlwj, mqsj, mqwj, mssj, mswj, ntwj, pwlj, pwrj, tmwj
%Rh Name of the execution manager defined for the jobnet
Character string of up to 255 bytes. By default, no characters are output.
n, rm
%ar Order in which units are executed
preceding-unit-name, succeeding-unit-name, connection-type Specify the name of a unit name. Use a character string of up to 30 bytes. The connection type is s or c. The default is -,-.
s: Sequential connection
c: Conditional connection
n, rm
%CO Start condition
and: AND
or: OR
rc
%eU JP1 user for job execution
ent: User who registered the job
def: User who defined the job
j, pj, qj, jdj, cj, cpj, orj, cmsj, evsj, evwj, flwj, lfwj, mlsj, mlwj, mqsj, mqwj, mssj, mswj, ntwj, pwlj, pwrj, tmwj
%cn Custom job name
Character string of up to 16 bytes. By default, no characters are output.
cj, cpj
%Te Command text
Character string of up to 1,023 bytes. By default, no characters are output.
j, cj, cpj
%sc Script file name (for UNIX), or target file name (for Windows)
Character string of up to 511 bytes. By default, no characters are output.
j, pj, qj, cj, cpj
%pm Parameter
Character string of up to 1,023 bytes. By default, no characters are output.
j, pj, qj, cj, cpj
%wk Work path name
Character string of up to 511 bytes. By default, no characters are output.
j, pj
%ev Environment variable file name
Character string of up to 511 bytes. By default, no characters are output.
j, pj
%En Environment variable
Character string of up to 20,479 bytes. By default, no characters are output.
j, pj, cj, cpj
%si Standard input file name
Character string of up to 511 bytes. By default, no characters are output.
j, pj
%so Standard output file name
Character string of up to 511 bytes. By default, no characters are output.
j, pj, cj, cpj
%se Standard error output file name
Character string of up to 511 bytes. By default, no characters are output.
j, pj, cj, cpj
%oa Option to update information in the standard output file
new: Outputs information to a new standard output file.
add: Adds information to the existing standard output file.
j, pj
%ea Option to update information in the standard error output file
new: Outputs information to a new standard error output file.
add: Adds information to the existing standard error output file.
j, pj
%Et Time-out period
1 to 1,440 minutes
j, pj, jdj, cj, cpj, cmsj, evsj, evwj, flwj, lfwj, mlsj, mlwj, mqsj, mqwj, mssj, mswj, ntwj, pwlj, pwrj, tmwj
%pr Execution priority of a jobnet or job
1 to 5. The default is -.
n, rm, j, pj, qj, cj, cpj
%rh Target host name
Character string of up to 255 bytes. By default, no characters are output.
n, rm, j, pj, jdj, cj, cpj, cmsj, evsj, evwj, flwj, lfwj, mlsj, mlwj, mqsj, mqwj, mssj, mswj, ntwj, pwlj, pwrj, tmwj
%un Target user name
Character string of up to 63 bytes. By default, no characters are output.
j, pj, cj, cpj
%jd End judgment
normal: Always normal
abnorm: Always abnormal
code: End code
exist: Normal if a file is created
modify: Normal if the file is updated
j, pj, qj, cj, cpj
%wt Threshold for the end with warning
0 to 2,147,483,647. The default is -.
j, pj, qj, cj, cpj
%Th Threshold for the abnormal end
0 to 2,147,483,647
j, pj, qj, cj, cpj
%jf End judgment file name
Character string of up to 511 bytes. By default, no characters are output.
j, pj, cj, cpj
%qu Queue name
Character string of up to 63 bytes. By default, no characters are output.
qj
%qm Queue manager host name
Character string of up to 255 bytes. By default, no characters are output.
qj
%rq Job name
Character string of up to 255 bytes. By default, no characters are output.
qj
%s1 to %s4 Transfer source file name
Character string of up to 511 bytes. By default, no characters are output.
%s1: Name of transfer source file 1
%s2: Name of transfer source file 2
%s3: Name of transfer source file 3
%s4: Name of transfer source file 4
j, pj, qj
%d1 to %d4 Transfer destination file name
Character string of up to 511 bytes. By default, no characters are output.
%d1: Name of transfer destination file 1
%d2: Name of transfer destination file 2
%d3: Name of transfer destination file 3
%d4: Name of transfer destination file 4
j, pj, qj
%T1 to %T4 Option to delete the transfer destination file after the end of job execution
save: Saves the file.
delete: Deletes the file.
j, pj
%ej Judgment method
greater: Greater than the judgment value
greater: equal Equal to or greater than the judgment value
less: Less than the judgment value
less equal: Equal to or less than the judgment value
equal: Equal to the judgment value
not equal: Not equal to the judgment value
exist: A file is created.
not exist: No file is created.
variable greater: The variable is greater than the judgment value.
variable greater equal: The variable is equal to or greater than the judgment value.
variable less: The variable is less than the judgment value.
variable less equal: The variable is equal to or less than the judgment value.
variable equal: The variable is equal to the judgment value.
variable not equal: The variable is not equal to the judgment value.
string equal: The variable is equal to the judgment string.
string part equal: The variable includes the judgment string.
string not equal: The variable is not equal to the judgment string.
string not null: The value of the variable exists.
string null: The value of the variable does not exist.
jdj
%eC End code for judgment
0 to 4,294,967,295
jdj
%ef End judgment file name
Character string of up to 511 bytes. By default, no characters are output.
jdj
%jV Variable name
String of up to 64 bytes. By default, nothing is output.
jdj
%jT Judgment string for variables
String of up to 511 bytes. By default, nothing is output.
jdj
%jI Judgment value for variables
Value of 0 to 2,147,483,647
jdj
%CI Additional status information reported to HP NNM
Character string of up to 256 bytes. By default, no characters are output.
cmsj
%CC Status reported to HP NNM
un: Unknown
no: Normal
wa: Warning
mi: Minor
ma: Major
cr: Critical
re: Restricted
te: Testing
di: Disabled
cmsj
%ED Detailed event information
Character string of up to 1,024 bytes. By default, no characters are output.
evwj
%Eg Event issue source group ID
-1 to 9,999,999,999. The default is ********.
evwj
%EG Event issue source group name
Character string of up to 20 bytes. The default is ********.
evwj
%EH Event issue source host name, event destination host name
Character string of up to 255 bytes. By default, no characters are output.
evsj, evwj
%EI Monitor event ID
Character string of up to 17 bytes. The default is ********.
evwj
%eI Send event ID
Character string of up to 8 bytes. The default is ********.
evsj
%Ei Event issue source IP address
Character string of up to 15 bytes. The default is ********.
evwj
%eM Event message information (Send)
Character string of up to 1,023 bytes. By default, no characters are output.
evsj
%EM Event message information (Receive)
Character string of up to 1,024 bytes. By default, no characters are output.
evwj
%Ep Event issue source process ID
Character string of up to 15 bytes. The default is ********.
evwj
%eS Event level for the extended attribute of an event (Send)
em: Sets Emergency.
al: Sets Alert.
cr: Sets Critical.
er: Sets Error.
wr: Sets Warning.
no: Sets Notice.
in: Sets Information.
db: Sets Debug.
evsj
%ES Event level for the extended attribute of an event (Receive)
em: Sets Emergency as the condition to be met.
al: Sets Alert as the condition to be met.
cr: Sets Critical as the condition to be met.
er: Sets Error as the condition to be met.
wr: Sets Warning as the condition to be met.
no: Sets Notice as the condition to be met.
in: Sets Information as the condition to be met.
db: Sets Debug as the condition to be met.
evwj
%Ef Optional extended attribute of an event (Send)
Character string of up to 128 bytes. By default, no characters are output.
evsj
%ET Conditions of end judgment
n: Always normal end
a: Always abnormal end
n, file-name: Normal end if the message matches the contents of the specified file
a, file-name: Abnormal end if the message matches the contents of the specified file
d, file-name: Normal end if detailed information matches the contents of the specified file
b, file-name: Abnormal end if detailed information matches the contents of the specified file
The file name consists of a character string of up to 256 bytes.
evwj
%Eu Event issue source user ID
-1 to 9,999,999,999. The default is ********.
evwj
%EU Event issue source user name
Character string of up to 20 bytes. The default is ********.
evwj
%EF Optional extended attribute of an event (Receive)
Character string of up to 2,048 bytes. By default, no characters are output.
evwj
%FC Monitoring conditions
c: Monitors file creation.
d: Monitors file deletion.
s: Monitors file resizing.
m: Monitors the changes in the updating time of the last file.
flwj
%FF Name of a file to be monitored
Character string of up to 255 bytes. By default, no characters are output.
flwj
%FI Monitoring interval
1 to 600 seconds
flwj
%FO When there is a file to be monitored
y: Conditions are met (Normal termination).
n: Monitoring is continued.
flwj
%Lw Error option for a file not created
yes: Error
no: Not error
lfwj
%Ld Output data format for log files
s: Sequential file (Data is appended to one log file, and when the file is filled to its capacity, a new log file is created with another name, and new log data is written to the new file.)
s2: Sequential file (A log file with the same name is continuously used for logging by creating a new file with the same name after backing up the current file with another name or deleting the current file.)
w1: Wraparound (When log data is written to the end of the log file, the existing data is overwritten with new data, starting with the beginning of the file.)
w2: Wraparound (When log data is written to the end of the log file, the existing data is deleted and then new data is written from the beginning of the file.)
lfwj
%LF Log file name
Character string of up to 256 bytes. By default, no characters are output.
lfwj
%LL Header
l: Number of rows (0 to 99,999 rows)
s: Size (0 to 9,999,999 rows)
-: None
lfwj
%LM Data other than log information (the distinction between AND and OR is not output.)
Character string of up to 1,024 bytes. By default, no characters are output.
lfwj
%Lm Data other than log information
Character string of up to 1,024 bytes. By default, no characters are output.
A colon (:) is output for AND. A linefeed is output for OR.

Output example: For "AAA" and "BBB" or "CCC"
"AAA":"BBB"
"CCC"
lfwj
%LX Maximum length of event data
2 to 512 (bytes)
lfwj
%LR Record format of log data
v: Delimits the row by a variable-length record (consisting of a character string of 3 to 4 bytes).
f: Delimits the row by a fixed-length record (consisting of a character string of 1 to 9,999,999 bytes).
lfwj
%LI File search interval
1 to 86,400 seconds
lfwj
%Ls Search start option
y: Enters data from its top.
n: Does not enter data from its top.
lfwj
%LD Data to be trapped (the distinction between AND and OR is not output.)
Character string of up to 2,048 bytes. By default, no characters are output.
lfwj
%LT Data to be trapped
Character string of up to 2,048 bytes. By default, no characters are output.
A colon (:) is output for AND. A linefeed is output for OR.

Output example: For "AAA" and "BBB" or "CCC"
"AAA":"BBB"
"CCC"
lfwj
%MA "email-address", or xxx:"email-address" (Only for an email sending job)
to:"email-address": Sends email to the destination.
cc:"email-address": Sends an email copy to the destination.
bcc:"email-address": Sends an email copy to the destination; like paper BBC (blind carbon copy), this copy is hidden from other recipients.
The email address consists of a character string of up to 256 bytes.
mlsj, mlwj
%ML Received email list name
Character string of up to 255 bytes. By default, no characters are output.
mlwj
%MP Profile name
Character string of up to 256 bytes. By default, no characters are output.
mlsj, mlwj
%Ms Email saving
yes: Saves email.
no: Does not save email.
mlwj
%MS Subject
Character string of up to 256 bytes. By default, no characters are output.
mlsj, mlwj
%MF Name of a folder to save the attached file
Character string of up to 256 bytes. By default, no characters are output.
mlwj
%mF Attached file name
Character string of up to 256 bytes. By default, no characters are output.
mlsj
%mf Name of a list file to list the attached file
Character string of up to 256 bytes. By default, no characters are output.
mlsj, mlwj
%Mt Name of a file to save text
Character string of up to 256 bytes. By default, no characters are output.
mlwj
%MT Text
Character string of up to 512 bytes. By default, no characters are output.
mlsj, mlwj
%mt Text file name
Character string of up to 256 bytes. By default, no characters are output.
mlsj
%QC Correlation ID
Character string of up to 24 bytes. The default is -.
mqsj, mqwj
%QD Message ID
Character string of up to 24 bytes. The default is -.
mqsj, mqwj
%qE Dead letter queue name
Character string of up to 48 bytes. The default is -.
mqsj
%qH Holding time
1 to 9,999,999 minutes. The default is -.
mqsj
%QM Model queue name
Character string of up to 48 bytes. The default is -.
mqsj, mqwj
%qd Message data file name
Character string of up to 256 bytes. By default, no characters are output.
mqsj
%qF Message format name
Character string of up to 8 bytes. The default is -.
mqsj
%qM Queue manager name
Character string of up to 48 bytes. The default is -.
mqsj
%qp Program name for related queue management
Character string of up to 48 bytes. The default is -.
mqsj
%qR Priority
0 to 9. The default is -.
mqsj
%qP Permanence
yes: Permanent
no: Not permanent
mqsj
%QQ Queue name
Character string of up to 48 bytes. The default is -.
mqsj, mqwj
%QS Message storage file name
Character string of up to 256 bytes. By default, no characters are output.
mqwj
%SA Application information
0 to FFFFFFFF. The default is -.
mssj, mswj
%SH Holding time
-1 to 2,147,483,647 (seconds)
mssj
%sJ Message storage to the journal queue
yes: Stores the message.
no: Does not store the message.
mssj
%SM Message label
Character string of up to 249 bytes. The default is -.
mssj, mswj
%sL Delivery limit time
-2 to 2,147,483,647 (seconds)
mssj
%sM Delivery mode
h: High-speed mode
r: Recoverable mode
mssj
%sP Priority
0 to 7
mssj
%sl Queue label name
Character string of up to 124 bytes. The default is -.
mssj
%SQ Queue path name
Character string of up to 259 bytes. By default, no characters are output.
mssj, mswj
%SR Correlation ID
Character string of up to 20 bytes. The default is -.
mssj, mswj
%SF Message storage file name
Character string of up to 256 bytes. By default, no characters are output.
mswj
%sF Text file name
Character string of up to 259 bytes. By default, no characters are output.
mssj
%sT Text type
0 to FFFFFFFF. The default is -.
mssj
%sU Message storage to the dead letter queue
yes: Stores the message.
no: Does not store the message.
mssj
%NJ Classification judgment conditions
yes: Judges the classification.
no: Does not judge classification.
ntwj
%NC Classification
Character string of up to 255 bytes. By default, no characters are output.
ntwj
%ND Explanation
Character string of up to 1,024 bytes. By default, no characters are output.
ntwj
%Nj Judgment conditions for an event ID
yes: Judges the classification.
no: Does not judge classification.
ntwj
%NI Event ID
Character string of up to 16 bytes. The default is -.
ntwj
%NE Event type
I: Monitors the information event.
w: Monitors the warning event.
e: Monitors the error event.
s: Monitors the success audit event.
f: Monitors the failure audit event.
ntwj
%NL Log type
sys: Monitors the system log.
sec: Monitors the security log.
app: Monitors the application log.
dns: Monitors the DNS Server log (for Windows 2000 only).
dir: Monitors the Directory Service log (for Windows 2000 only).
frs: Monitors the file reproduction service log (for Windows 2000 only).
ntwj
%Ns Judgment conditions for a source
yes: Judges the classification.
no: Does not judge classification.
ntwj
%NS Source
Character string of up to 255 bytes. The default is -.
ntwj
%jp Macro variable
Character string of up to 2,048 bytes. By default, no characters are output.
evwj, flwj, lfwj, mlwj, mqwj, mswj, ntwj, tmwj
%Mp Platform type
u: Execution in the UNIX environment
p: Execution in the Windows environment and Windows-compatible environment
cmsj, evsj, mlsj, mlwj, mqsj, pwlj
%PT Type of execution
f: Turns off the power supply.
r: Shuts down, than restarts the power supply.
s: Shuts down.
pwlj
%Pf Type of an end request
m: Termination with monitoring
r: Restrictive termination
f: Kill
p: Planned termination
pwlj
%PH Target host name
Character string of up to 255 bytes. By default, no characters are output.
pwrj
%PF Request type
o: Turns on the power supply.
m: Termination with monitoring
r: Restrictive termination
f: Kill
p: Forced termination
s: Forced stop
pwrj
%PN Time when the power supply is turned on next
n: Does not set the next power-on time.
a: Validates the next power-on time set for the agent.
c: {[mm/dd.]hh:mm}
Next power-on time
mm: 1 to 12 (month)
dd: 1 to 31 (day)
hh: 0 to 23 (hour)
mm: 0 to 59 (minute)
pwrj
%PR Restart
yes: Restarts the agent host.
no: Does not restart the agent host.
pwrj
%PW Waiting for the end of power-off
yes: If you turns off the power supply for a remote power agent, the system waits for a shutdown.
no: Does not wait for a shutdown.
pwrj
%PM Type of platform subject to power control
u: Execution in the UNIX environment
p: Execution in the Windows environment and Windows-compatible environment
pwrj
%Tw Waiting time
1 to 1,440 minutes.
tmwj
%LN Link network group name
Character string of up to 13 bytes. By default, no characters are output.
hln
%SP Starting point
n: None
s: Select
a: All
hln
%Sh Jobnet name for the mainframe that you want to select as the starting point.
Character string of up to 17 bytes. UP to 16 jobnet names are output. By default, no characters are output.
hln
%EP Ending point
n: None
s: Select
a: All
hln
%Eh Jobnet name for the mainframe that you want to select as the ending point.
Character string of up to 17 bytes. UP to 16 jobnet names are output. By default, no characters are output.
hln
%gt Job group type
n: Job group
p: Planning group
No characters are output for a group other than a job or planning group.
g
%Ed Date and time of creation mg, g, mn, rc, n, rm, j, pj, qj, jdj, cj, cpj, orj, cmsj, evsj, evwj, flwj, lfwj, mlsj, mlwj, mqsj, mqwj, mssj, mswj, ntwj, pwlj, pwrj, tmwj, hln, nc
%jt Job queuing attribute type
q: Has the queuing attribute.
n: Does not have the queuing attribute.
j, pj, evsj, mlsj, mqsj, mssj, cmsj, pwlj, pwrj
%es Event job time-out state
kl: Killed
nr: Ended normally
wr: Ended with warning
an: Ended abnormally
evwj, flwj, lfwj, mlwj, mqwj, mswj, ntwj, tmwj
%Ee Searches for events before execution
Searches for the JP1 events that occurred since the specified minutes before the JP1 event reception monitoring job was executed.
1 to 720 minutes.
no: Does not search for previous JP1 events.
evwj
%eK Event arrival check
y: Checks the arrival of the event.
n: Does not check the arrival of the event.
evsj
%eP Event arrival check interval.
3 to 600 seconds.
If you do not check the arrival of the event, specify -.
evsj
%eR Number of times event arrival is checked
0 to 999 times.
If you do not check the arrival of the event, specify -.
evsj
%fd Time required for executing the jobnet or remote jobnet for which the end delay is monitored
1 to 2,879 minutes.
Alternatively, the time required for executing the job. 1 to 1,440 minutes.
By default, no characters are output.
n, rm, j, pj, qj, cj, cpj, cmsj, evsj, evwj, flwj, lfwj, mlsj, mlwj, mqsj, mqwj, mssj, mswj, ntwj, pwlj, pwrj, tmwj
%AB Operation that occurs after a jobnet with start conditions terminates abnormally
exec: Start the execution of the jobnet.
hold: Hold the execution of the jobnet.
stop: Stop the monitoring of start conditions.
rc
%mS Startup of multiple monitoring generations
multi: Another monitoring generation starts.
wait: Another monitoring generation waits for the current monitoring generation to terminate.
skip: Another monitoring generation does not start.
rc
%gs Whether to stay an execution generation whose start conditions are satisfied
yes: Execution of the jobnet is not repeated so that the generation stays.
no: Execution of the jobnet is repeated so that the generation does not stay.
rc
%Nl Whether to control the root jobnet execution order
y: The root jobnet execution order is controlled.
n: The root jobnet execution order is not controlled.
g, n
%Nn Jobnet connector name
Character string of no more than 930 bytes
By default, no characters are output.
g, n
%Nm Root jobnet execution order control method
y: Root jobnets are executed synchronously with jobnet connectors.
n: Root jobnets are executed asynchronously with jobnet connectors.
-: The root jobnet execution order is not controlled.
g, n
%Nr Name of the root jobnet to be connected
Character string of no more than 930 bytes.
By default, no characters are output.
nc
%Ud Last update time of a unit including its subordinate units

Cautionary note
If the ajsprint command is executed with the %Ud format indicator specified, processing takes time because the command references information about all units subordinate to the target units. The processing time depends on the total number of subordinate units.
mg, g, mn, rc, n, rm, j, pj, qj, jdj, orj, cmsj, evsj, evwj, flwj, lfwj, mlsj, mlwj, mqsj, mqwj, mssj, mswj, ntwj, pwlj, pwrj, tmwj, hln, nc

#1
Format indicator that can be set for the -t option

#2
For details about the output format, see Table 2-13.

#3
For details about the abbreviations of unit types, see the description of the parameter ty= in 4.2.1 Attribute definition in the manual Job Management Partner 1/Automatic Job Management System 3 Command Reference 2.
 

Table 2-12 Other format indicators

Format indicator Output information
%% %
%n Line feed character
%t Tab character
%x Current date#
%X Current time#

#
Time at which you started executing the ajsprint command. For details about the output format, see the following table:
 

Table 2-13 Output format of format indicators

Format indicator Output format
%ud
%Ed
%Ud
MMM DD YYYY hh:mm:ss
Example:
DEC 30 2006 18:39:12
%cl
%op
%ed
%x
YYYY/MM/DD
Example:
2006/12/30
When not specified: ****/**/**
%X hh:mm:ss
Example:
12:30:30
%Sd [N,]{[[yyyy/]mm/]{[+|*|@]dd|[+|*|@]b[-DD]|[+]{su|mo|tu|we|th|fr|sa}[:{n|b}]}|en|ud}
  • N indicates a rule number when multiple schedules are defined (1 to 144).
  • yyyy indicates a year of four digits.
  • mm indicates a month.
  • + indicates relative days.
  • * indicates an open day.
  • @ indicates a closed day.
  • dd indicates a day in a month.
  • b indicates the last day.
  • -DD indicates the number of days from the last date (1 to 35).
  • su, mo, tu, we, th, fr and sa indicate the days of the week beginning with Sunday (Sunday to Saturday).
  • n indicates the n-th week (1 to 5).
    By default, the system assumes the start date to be the next day of the week after the date when the jobnet was registered for execution and the date when the ajsschedule command was executed. If you do not specify anything when either year or month is specified for the execution start date, the system assumes the first week when you register anything for execution and when you execute the ajsschedule command.
  • b indicates the last day of the month.
  • en indicates the specified day to start execution.
  • ud indicates "undefined."
%St [N,][+]hh:mm
  • N indicates a rule number when multiple schedules are defined (1 to 144).
  • + indicates relative time.
  • hh indicates hours (0 to 47).
  • mm indicates minutes (0 to 59).
  • When not specified: **:**
%sy
%ey
[N,]{hh:mm|Pmmmm}
  • N indicates a rule number when multiple schedules are defined (1 to 144).
  • hh indicates hours (0 to 47).
  • mm indicates minutes (0 to 59).
  • P indicates M (from the root jobnet), U (from the upper-level jobnet) or C (from the jobnet itself).
  • mmmm indicates minutes (0 to 2,879).
  • When not specified: **:**

Table 2-14 Indications of the permission mode

Digit Meaning value
1 Sets a set user ID bit and a set group ID bit for a job.

Set user ID bit provided
4 or 5

Set group ID bit provided
2 or 3

Both provided
6 or 7

Neither provided
0 or 1
2 to 4 Octal value indicating the update, manipulation, reference, or no privilege for the owner (2nd digit), group (3rd digit), and others (4th digit) Update: 7
Manipulation: 5
Reference: 4 or 6
No privilege: 0, 1, 2, or 3

Example 1

The following commands output calendar information on job group group1 to the standard output file.

The base date is the 21st.

(1) When information on one day (October 30, 2010) is output:
 
   ajsprint -c 2010/10/30 /group1
 

Output example
 
o (open day) or x (closed day)
o
 

(2) When information on one month (October 2010) is output:
 
   ajsprint -c 2010/10 /group1
 

Output example
 
First Date of Output/Day of week/Standard Day/o (open day) or x (closed day)...
Oct 2010             Wed         Oct 21 2010 o o o o x x o o o o o x x ........
 

(3) When information on 12 months (2010) is output:
 
ajsprint -c 2010 /group1
 

Output example
 
First Date of Output/Day of week/Standard Day/o (open day) or x (closed day)...
Jan 2010             Wed        Jan 21 2010 o o o o x x o o o o o x x ...
Feb 2010             Sat        Feb 21 2010 o x x o o o o o x x o o o ...
(Omitted)
Dec 2010             Mon        Dec 21 2010 x o x o o o x x x x x x x ...
 

Example 2

Use the following commands to save and recover all the unit definition information and calendar information under the root job group "/".

Using Windows version JP1/AJS3

The procedure for saving is explained below together with how to specify commands.

  1. Save the unit definition information in all the units.
     
    ajsprint -a /* > c:\temp\winbackup.txt
     
  2. Save the calendar information for the open and closed days in the root job group "/" (that is, the root job group AJSROOT).
     
    ajsprint -d / > c:\temp\rootcal.txt
     
  3. Save the base time, base day, and month term of AJSROOT.
     
    ajsprint -f"-lt %st -ld %sd -md %md" / > c:\temp\calopt.txt
     
  4. Save the comment, ownership, and group of AJSROOT.
     
    ajsprint -f"-C %cm -o %ow -g %gr" / > c:\temp\chgopt.txt
     

For the recovery procedure, you would specify the commands as follows:

  1. ajsdefine c:\temp\winbackup.txt
  2. ajscalendar -df c:\temp\rootcal.txt /
  3. for /F "tokens=*" %i in (c:\temp\calopt.txt) do ajscalendar %i /
  4. for /F "tokens=*" %i in (c:\temp\chgopt.txt) do ajschange %i /

Using the UNIX version JP1/AJS3

The procedure for saving is explained below together with how to specify commands.

  1. Save the unit definition information in all the units.
     
    ajsprint -a "/*" > /tmp/unitbackup.txt
     
  2. Save the calendar information for the open and closed days in the root job group "/" (that is, the root job group AJSROOT).
     
    ajsprint -d / > /tmp/rootcal.txt
     
  3. Save the base time, base day, and month term of AJSROOT.
     
    ajsprint -f"-lt %st -ld %sd -md %md" / > /tmp/calopt.txt
     
  4. Save the comment, ownership, and group of AJSROOT.
     
    ajsprint -f"-C %cm -o %ow -g %gr" / > /tmp/chgopt.txt
     

For the recovery procedure, you would specify the commands as follows:

  1. ajsdefine /tmp/unitbackup.txt
  2. ajscalendar -df /tmp/rootcal.txt /
  3. ajscalendar 'cat /tmp/calopt.txt' /
  4. ajschange 'cat /tmp/chgopt.txt' /
 

Example 3

Search for macro variables defined in the unit placed under the jobnet (/net1) and output them in list form. One assumption is that there are three jobs (job1, job2, and job3) under this jobnet. Let us also assume that the parameter (prm) of job1 has ?AJS2PARAM? defined and that the definition of the environment variable (env) of job3 has ?AJS2ENV1? and ?AJS2ENV2? defined.

 
ajsprint -F AJSROOT1 -v /net1
 

Output example
 
/net1/job1 prm ?AJS2PARAM?
/net1/job3 env ?AJS2ENV1?
/net1/job3 env ?AJS2ENV2?

[Contents][Back][Next]


[Trademarks]

Copyright (C) 2009, 2010, Hitachi, Ltd.
Copyright (C) 2009, 2010, Hitachi Solutions, Ltd.