ajsprint
- Organization of this page
Format
ajsprint [-F service-name] {-a|-c year[/month[/day]]|-d|-f format-indicator|-v} [-t format-indicator] [-s {yes|no}] [-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:
-
JP1_AJS_Admin privilege
-
JP1_AJS_Manager privilege
-
JP1_AJS_Editor privilege
-
JP1_AJS_Operator privilege
-
JP1_AJS_Guest privilege
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:
-
Enable the schedule rule and do not depend on the schedule for the upper-level jobnet.
-
Delete the schedule rule and depend on the schedule for the upper-level jobnet.
For details about how to set the AJSPRINTNETSCHPRF environment setting parameter, see 20.4.2(79) AJSPRINTNETSCHPRF in the JP1/Automatic Job Management System 3 Configuration Guide.
-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.
-
year
You can specify a value between 1994 and 2036 for the year.
-
month
You can specify value between 1 and 12 for the month.
-
day
You can specify a value between 1 and 31 for the day.
You can select one of the following output formats. (Also see Example 1 later.)
-
year/month/day
Outputs calendar information on that day.
-
year/month
Outputs calendar information on one month after the base date#.
-
year
Outputs calendar information on the 12 months from the base date# for each of January to December.
- #
-
You can use the ajscalendar command to specify the base date.
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:
-
-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 5.1 Creating a unit definition file.
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 information 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):
-
information-1 information-2 information-3
information-1: Full name of the unit
information-2: Unit definition parameter name
information-3: Macro variable name in the definition information
These items of information are separated by single-byte spaces before they are output.
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 information 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.
-s {yes|no}
Specifies whether to fix the order of relation line information entries that are output in unit definition information when the -f or -a option is specified. If the -f option is specified, each entry of relation line information is output as a value represented by the %ar format indicator. If you specified the -a option, each entry of relation line information is output as the ar parameter.
-
yes
Fixes the output order of relation line information entries for units. The following rules apply when relation line information entries are output:
-
Entries are output in ascending order of the character codes of the preceding unit names.
-
If the preceding units are the same, entries are output in ascending order of character codes of the succeeding unit names.
-
-
no
Does not fix the output order of relation line information entries for units. The output order of relation line entries depends on the unit creation order.
If you omit this option, the value specified for the AJSPRINTSORTUNITINF environment setting parameter (yes or no) is used for operation. If you omit both the -s option and the AJSPRINTSORTUNITINF environment setting parameter, no is assumed.
If the values of the -s option and the AJSPRINTSORTUNITINF environment setting parameter are different, the -s option takes precedence over the parameter.
For details about how to set the AJSPRINTSORTUNITINF environment setting parameter, see 20.4.2(109) AJSPRINTSORTUNITINF in the JP1/Automatic Job Management System 3 Configuration Guide.
Use the -s yes option to compare definition information of two units when, for example, you migrate an environment or customize a defined unit as shown below:
-
In the environment before migration, execute the ajsprint command to output unit definition information. Then, in the environment after migration, execute the ajsdefine command to import the unit definition information.
-
Create a jobnet by executing a defined jobnet, and then customize the definition of the original jobnet.
To compare information as shown above, specify yes for the -s option to output definition information. Thus, relation line information entries are output in alphabetical order of unit name for the original jobnet, its copy, and a new jobnet created by the ajsdefine command. This prevents unintended differences from being generated.
For examples of using the -s option, see Example 4 later and 13.1.8 Editing units defined by JP1/AJS3 - View and comparing definitions before and after editing in the JP1/Automatic Job Management System 3 Administration Guide.
-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
-
Either of the following users can output the unit definition:
-
A user granted the reference privilege when the unit whose definition is output was defined or when its attributes were changed
-
A JP1 user mapped to the OS user who has Administrators or superuser privileges
Note, however, that if yes is set after changing the ADMACLIMIT environment setting parameter from its default, even a JP1 user who was mapped to an OS user with Administrators or superuser privileges must have the reference privilege.
-
-
When you specify the -a option to output the unit definition information in the unit, if the defined content is equal to the default value of a parameter, the parameter is not output. If the parameter is not output, then its default value is defined as in the table below. For details about individual parameters, see 5.2 Definition format and parameters.
Table 3‒12: Parameter default values Unit type
Parameter
Default value
Job group
Gty
n
Jobnet
Wt
N,no
Wc
N,no
Cftd
N,no
Rg
1
Ha
n
Cd
no
De
y
Ms
sch
mp
n
mm
and
nmg
n
ega
none
uem
n
start condition
ab
exec
mcs
m
cgs
y
UNIX/PC job
soa
new
sea
new
jd
cod
abr
n
ha
n
eu
ent
jty
q
mm
and
nmg
n
ega
none
uem
n
Queue job
jd
cod
abr
n
ha
n
eu
ent
mm
and
nmg
n
ega
none
uem
n
Judgment job
ej
gt
ejm
ge
eju
le
Flexible job
jd
cod
abr
n
ha
n
eu
ent
mm
and
nmg
n
ega
none
uem
n
HTTP Connection job
htknd
GET
htspt
diff
jd
cod
abr
n
ha
n
eu
def
mm
and
nmg
n
ega
none
uem
n
JP1 event reception-monitoring job
evtmc
n
ha
n
eu
ent
evesc
no
ets
kl
mm
and
nmg
n
ega
none
uem
n
File monitoring job
flwc
c
flwi
60
flco
n
ha
n
eu
ent
ets
kl
mm
and
nmg
n
ega
none
uem
n
Email reception-monitoring job
pfm
p
mlsav
y
ha
n
eu
ent
ets
kl
mm
and
nmg
n
ega
none
uem
n
Message queue reception-monitoring job
ha
n
eu
ent
ets
kl
mm
and
nmg
n
ega
none
uem
n
MSMQ reception-monitoring job
ha
n
eu
ent
ets
kl
mm
and
nmg
n
ega
none
uem
n
Log file monitoring job
lfdft
s
lfsrc
n
lfcre
n
ha
n
eu
ent
ets
kl
mm
and
nmg
n
ega
none
uem
n
Windows event log monitoring job
ntnsr
y
ntncl
y
ntnei
y
ha
n
eu
ent
ets
kl
mm
and
nmg
n
ega
none
uem
n
Execution interval control job
etn
n
ha
n
eu
ent
ets
kl
mm
and
nmg
n
ega
none
uem
n
JP1 event sending job
pfm
p
ha
n
eu
ent
evsrt
n
evspl
10
evsrc
0
jty
q
mm
and
nmg
n
ega
none
uem
n
Email sending job
pfm
p
ha
n
eu
ent
jty
q
mm
and
nmg
n
ega
none
uem
n
Message queue sending job
mqprm
n
pfm
p
ha
n
eu
ent
jty
q
mm
and
nmg
n
ega
none
uem
n
MSMQ sending job
msmod
h
msjnl
n
msunr
n
ha
n
eu
ent
jty
q
mm
and
nmg
n
ega
none
uem
n
OpenView status report job
cmsts
un
pfm
p
ha
n
eu
ent
jty
q
mm
and
nmg
n
ega
none
uem
n
Local power control job
pwlt
f
pwlf
f
pfm
p
ha
n
eu
ent
jty
q
mm
and
nmg
n
ega
none
uem
n
Remote power control job
pwrn
a
pwrr
n
pwrw
n
pwrp
p
pfm
p
ha
n
eu
ent
jty
q
mm
and
nmg
n
ega
none
uem
n
Custom UNIX/PC job
jd
cod
abr
n
ha
n
eu
ent
soa
new
sea
new
mm
and
nmg
n
ega
none
uem
n
Jobnet connector
mm
and
nmg
n
ega
none
uem
n
-
If the command is executed for a release target jobnet (root jobnet for which release entry is made), only the jobnet definitions in Being applied status are output.
Arguments that can be specified when executing the command from JP1/AJS3 - View
You can specify the following arguments when executing the ajsprint command from JP1/AJS3 - View:
No. |
Arguments |
Required? |
---|---|---|
1 |
-F service-name |
Y |
2 |
-a |
-- |
3 |
-c year[/month[/day]] |
-- |
4 |
-d |
-- |
5 |
-f format-indicator |
-- |
6 |
-v |
-- |
7 |
-s {yes|no} |
-- |
8 |
-t format-indicator |
-- |
9 |
-J |
-- |
10 |
-N |
-- |
11 |
-G |
-- |
12 |
-R |
-- |
13 |
-L |
-- |
14 |
-E |
-- |
15 |
-T |
-- |
16 |
job-name-or-jobnet-name-or-job-group-name |
Y |
- Legend:
-
Y: Required
--: Optional
You cannot specify any other options when executing the ajsprint command from JP1/AJS3 - View.
For details about how to execute JP1/AJS3 commands from JP1/AJS3 - View, see 10.4 Executing JP1/AJS3 commands from JP1/AJS3 - View in the JP1/Automatic Job Management System 3 Operator's Guide.
Return values
0 |
Normal end |
Multiple of 4 within the range from 4 to 124 |
Abnormal end |
Additional information
-
This section describes how to migrate information (job groups, jobnets, jobs, calendar information, etc.) specified on one server ("Server A") to another ("Server B"), as well as an example in which the command is actually used. You can use this procedure when information defined on a development server is migrated to a server for actual operation.
-
Execute the ajsprint command on Server A and output (save) the definition information to a file.
ajsprint */** > temporary-file-name
-
Execute the ajsdefine command on Server B and recover the information saved in step 1.
ajsdefine -d / temporary-file-name
- Cautionary note
-
With this method, you cannot save or recover the calendar information and other items defined in root job groups. This procedure is mentioned later in Example 2.
-
-
Table 3-13 lists the format indicators to output definitions of units. You can set all the format indicators listed in the table for the -f option. For the -t option, you can set only the format indicators with a superscript (#1).
Depending on the unit type, there are restrictions for which you can specify format indicators. If you specify a format identifier that cannot be specified for a unit type, the information corresponding to the format identifier is not output. Abbreviations are used to specify which format indicators are applicable to which unit types. For these abbreviations, see the ty parameter in 5.2.1 Attribute definition.
Table 3-14 lists the other format indicators.
Table 3-15 provides the output formats of the format indicators.
Table 3-16 lists the indications of the permission mode.
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, cj, cpj, orj, cmsj, evsj, evwj, flwj, lfwj, mlsj, mlwj, mqsj, mqwj, mssj, mswj, ntwj, pwlj, pwrj, tmwj, nc, fxj, htpj |
%jn#1 |
unit-name Character string of up to 30 bytes |
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, nc, fxj, htpj |
%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, cj, cpj, orj, cmsj, evsj, evwj, flwj, lfwj, mlsj, mlwj, mqsj, mqwj, mssj, mswj, ntwj, pwlj, pwrj, tmwj, nc, fxj, htpj |
%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 fxjob: Flexible job rfxjob: Flexible job for recovery htpjb: HTTP Connection job rhtpjb: HTTP Connection 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, cj, cpj, orj, cmsj, evsj, evwj, flwj, lfwj, mlsj, mlwj, mqsj, mqwj, mssj, mswj, ntwj, pwlj, pwrj, tmwj, nc, fxj, htpj |
%ow#1 |
Owner name Character string of up to 31 bytes. By default, no characters are output. |
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, nc, fxj, htpj |
%gr#1 |
JP1-resource-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, cj, cpj, orj, cmsj, evsj, evwj, flwj, lfwj, mlsj, mlwj, mqsj, mqwj, mssj, mswj, ntwj, pwlj, pwrj, tmwj, nc, fxj, htpj |
%ud#1 |
Last updated time#2 |
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, nc, fxj, htpj |
%cm |
Comment Character string of up to 80 bytes. By default, no characters are output. |
mg, g, mn, rc, n, rm, j, pj, qj, jdj, cj, cpj, cmsj, evsj, evwj, flwj, lfwj, mlsj, mlwj, mqsj, mqwj, mssj, mswj, ntwj, pwlj, pwrj, tmwj, nc, fxj, htpj |
%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 961 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, rc, n, rm |
%eN |
Unit name enclosed by type symbols contained in the specified unit Character string of 35 or fewer bytes. The enclosing symbols indicate the type of each unit. <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 !name-of-the-jobnet-with-start-conditions! [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 [OpenView-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 [flexible-job]c [HTTP-connection-job]H In the case of a recovery unit, enclosing symbols are doubled.
|
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, rc, n, rm |
%eH |
Horizontal display position of a unit contained in the specified unit 0 to 16,000 pixels |
g, rc, n, rm |
%eV |
Vertical display position of a unit contained in the specified unit 0 to 10,000 pixels |
g, rc, 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, db, da, or n. C indicates shift days, being 1 to 31. c indicates the maximum number of shift days, being 1 to 31. - means none. If m is n, - is output in place of C or c. If m is db or da, - is output in place of c. b: Execute on an open day preceding the previous day. a: Execute on an open day following the next day. db: Execute on a day preceding the previous day. da: 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, fxj, htpj |
%Rh |
Name of the execution manager defined for the remote jobnet Character string of up to 255 bytes. By default, no characters are output. |
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, cj, cpj, cmsj, evsj, evwj, flwj, lfwj, mlsj, mlwj, mqsj, mqwj, mssj, mswj, ntwj, pwlj, pwrj, tmwj, fxj, htpj |
%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, fxj |
%pm |
Parameter Character string of up to 1,023 bytes. By default, no characters are output. |
j, pj, qj, cj, cpj, fxj |
%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. If multiple environment variables are specified, they are output delimited by a semicolon (;). |
j, pj, cj, cpj, fxj |
%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, htpj |
%se |
Standard error output file name Character string of up to 511 bytes. By default, no characters are output. |
j, pj, cj, cpj, htpj |
%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, cj, cpj, cmsj, evsj, evwj, flwj, lfwj, mlsj, mlwj, mqsj, mqwj, mssj, mswj, ntwj, pwlj, pwrj, tmwj, htpj |
%pr |
Execution priority of a jobnet or job 1 to 5. The default is -. |
n, rm, j, pj, qj, cj, cpj, htpj |
%rh |
Execution agent name or Execution agent group name Character string of up to 255 bytes. By default, no characters are output. For a flexible job, the name of the execution agent to be used as a relay agent or the execution agent group name is output. |
n, rm, j, pj, cj, cpj, cmsj, evsj, evwj, flwj, lfwj, mlsj, mlwj, mqsj, mqwj, mssj, mswj, ntwj, pwlj, pwrj, tmwj, fxj, htpj |
%un |
Target user name Character string of up to 63 bytes. By default, no characters are output. |
j, pj, cj, cpj, htpj |
%jd |
End judgment normal: Always normal abnorm: Always abnormal code: Return code exist: Normal if a file is created modify: Normal if the file is updated |
j, pj, qj, cj, cpj, fxj, htpj |
%wt |
Threshold for the end with warning 0 to 2,147,483,647. The default is -. |
j, pj, qj, cj, cpj, fxj, htpj |
%Th |
Threshold for the abnormal end 0 to 2,147,483,647 |
j, pj, qj, cj, cpj, fxj, htpj |
%jf |
End judgment file name Character string of up to 511 bytes. By default, no characters are output. |
j, pj, cj, cpj, fxj, htpj |
%Ab |
Retry on abnormal end y: Automatic retry is performed for an abnormal end. n: Automatic retry is not performed for an abnormal end. |
j, pj, qj, cj, cpj, fxj, htpj |
%rs |
Lower limit of the return code for automatic retry 1 to 4,294,967,295. If omitted, - is output. In this case, abnormal threshold + 1 for end judgment is assumed at execution. Nothing is output if automatic retry is not performed on abnormal end. |
j, pj, qj, cj, cpj, fxj, htpj |
%re |
Upper limit of the return code for automatic retry 1 to 4,294,967,295. If omitted, - is output. In this case, 4,294,967,295, which is the maximum value, is assumed at execution. Nothing is output if automatic retry is not performed on abnormal end. |
j, pj, qj, cj, cpj, fxj, htpj |
%rc |
Maximum number of retry executions 1 to 12 (times). Nothing is output if automatic retry is not performed on abnormal end. |
j, pj, qj, cj, cpj, fxj, htpj |
%ri |
Retry interval 1 to 10 (minutes). Nothing is output if automatic retry is not performed on abnormal end. |
j, pj, qj, cj, cpj, fxj, htpj |
%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 63 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 range in: Within the judgment value range range out: Outside the judgment value range 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. variable range in: The variable is within the judgment value range. variable range out: The variable is outside the judgment value range. 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 part not equal: The variable does not include a judgment string. string not null: The value of the variable exists. string null: The value of the variable does not exist. |
jdj |
%eC |
Return code for judgment 0 to 4,294,967,295 |
jdj |
%el |
Lower limit end judgment code 0 to 4,294,967,295 This information is output when the judgment method is within the judgment value range or outside the judgment value range. |
jdj |
%eh |
Upper limit end judgment code 0 to 4,294,967,295 This information is output when the judgment method is within the judgment value range or outside the judgment value range. |
jdj |
%ef |
End judgment file name Character string of up to 260 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 |
%jS |
Lower limit variable judgment numeric value 0 to 2,147,483,647 This information is output when the judgment method indicates the variable is within the judgment value range or the variable is outside the judgment value range. |
jdj |
%jG |
Upper limit variable judgment numeric value 0 to 2,147,483,647 This information is output when the judgment method indicates the variable is within the judgment value range or the variable is outside the judgment value range. |
jdj |
%lP |
Boundary condition (lower limit) of the return code or variable judgment numeric value greater: Greater than the judgment value greater equal: Equal to or greater than the judgment value This information is output when the judgment method is within the judgment value range, outside the judgment value range, the variable is within the judgment value range, or the variable is outside the judgment value range. |
jdj |
%uP |
Boundary condition (upper limit) of the return code or variable judgment numeric value less: Smaller than the judgment value less equal: Equal to or smaller than the judgment value This information is output when the judgment method is within the judgment value range, outside the judgment value range, the variable is within the judgment value range, or the variable is outside the judgment value range. |
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 10 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.
|
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 yes: Enters data from its top. no: 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.
|
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 |
|
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 v: Monitors the verbose event. I: Monitors the information event. w: Monitors the warning event. e: Monitors the error event. c: Monitors the critical 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). oth: Monitors the log type specified for %Nt (any log type). |
ntwj |
%Nt |
Any log type Character string of up to 255 bytes. By default, no characters are output. |
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, then 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 turn off the power supply for a remote power agent, the system waits for a shutdown. no: Does not wait for a shutdown. The end of power-off means that the JP1/Power Monitor on the agent host reports the start of a shutdown to the manager host of the JP1/Power Monitor. |
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 |
%Tn |
Whether the unit is completed immediately after it starts y: Completed n: Not completed |
tmwj |
%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, fxj, htpj |
%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, htpj |
%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
|
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, fxj, htpj |
%mm |
Wait method and: Starts executing when all units whose ends are being waited for have finished executing. or: Starts executing when any one of the units whose ends are being waited for has finished executing. If no units whose ends are being waited for are defined for the wait condition, nothing is output. |
n, j, pj, qj, cmsj, evsj, evwj, flwj, lfwj, mlsj, mlwj, mqsj, mqwj, mssj, mswj, ntwj, pwlj, pwrj, tmwj, nc, cj, cpj, fxj, htpj |
%NM |
Behavior when there are no applicable generations of units whose ends are being waited for y: Start executing. n: Do not start executing. If no units whose ends are being waited for are defined for the wait condition, nothing is output. |
n, j, pj, qj, cmsj, evsj, evwj, flwj, lfwj, mlsj, mlwj, mqsj, mqwj, mssj, mswj, ntwj, pwlj, pwrj, tmwj, nc, cj, cpj, fxj, htpj |
%EN |
Name of unit whose end is being waited for You can specify a character string of 1 to 930 bytes. If no units whose ends are being waited for are defined for the wait condition, nothing is output. If more than one unit whose end is being waited for is defined for the wait condition, each unit appears on its own line. |
n, j, pj, qj, cmsj, evsj, evwj, flwj, lfwj, mlsj, mlwj, mqsj, mqwj, mssj, mswj, ntwj, pwlj, pwrj, tmwj, nc, cj, cpj, fxj, htpj |
%an |
Execution order relationship to unit whose end is being waited for The unit whose end is being waited for and the target unit are output in the following format: unit-whose-end-is-being-waited-for,target-unit-name The full path name of each unit is output as a character string of no more than 930 bytes. If no units whose ends are being waited for are defined for the wait condition, nothing is output. If more than one unit whose end is being waited for is defined for the wait condition, each unit appears on its own line. |
n, j, pj, qj, cmsj, evsj, evwj, flwj, lfwj, mlsj, mlwj, mqsj, mqwj, mssj, mswj, ntwj, pwlj, pwrj, tmwj, nc, cj, cpj, fxj, htpj |
%ga |
Behavior when there is an abnormal end in the execution generation. No information is output if there is no unit whose end is being waited for. exec: Start executing. execdeffer: Do not start executing. Note, however, that if the execution generation is in the Skipped so not exe. status, execution starts. none: Do not start executing. |
n, j, pj, qj, cmsj, evsj, evwj, flwj, lfwj, mlsj, mlwj, mqsj, mqwj, mssj, mswj, ntwj, pwlj, pwrj, tmwj, nc, cj, cpj, fxj, htpj |
%um |
Behavior when the monitoring generation is in the Unmonitored + Ended status. No information is output if there is no unit whose end is being waited for. y: Start executing. n: Do not start executing. |
n, j, pj, qj, cmsj, evsj, evwj, flwj, lfwj, mlsj, mlwj, mqsj, mqwj, mssj, mswj, ntwj, pwlj, pwrj, tmwj, nc, cj, cpj, fxj, htpj |
%da |
Destination or broadcast agent You can specify a character string of 1 to 128 bytes. By default, no characters are output. |
fxj |
%fg |
Broadcast execution method none: Do not perform broadcast execution. sync: Performs broadcast execution in synchronous mode. async: Performs broadcast execution in asynchronous mode. |
fxj |
%HC |
Connection configuration file name You can specify a character string of 1 to 511 bytes. By default, no characters are output. |
htpj |
%HK |
Request type
|
htpj |
%HS |
Transmission information file name You can specify a character string of 1 to 511 bytes. By default, no characters are output. |
htpj |
%HT |
Statuses store file name You can specify a character string of 1 to 511 bytes. By default, no characters are output. |
htpj |
%HD |
How to store received data: diff: The header and body of the received data acquired from the API are output to separate files. same: The header and body of the received data acquired from the API are output to the same file. |
htpj |
%HH |
Received header store file name You can specify a character string of 1 to 511 bytes. By default, no characters are output. |
htpj |
%HB |
Received body store file name You can specify a character string of 1 to 511 bytes. By default, no characters are output. |
htpj |
%HE |
Extended mode y: Extended mode is used. n: Extended mode is not used. |
htpj |
%HU |
Transmission information file name (URL parameter) You can specify a character string of 1 to 511 bytes. By default, no characters are output. |
htpj |
%HM |
Transmission information file name (message body) You can specify a character string of 1 to 511 bytes. By default, no characters are output. |
htpj |
%HR |
Return code specification You can specify a character string of 1 to 511 bytes. By default, no characters are output. |
htpj |
- #1
-
Format indicator that can be set for the -t option
- #2
-
For details about the output format, see Table 3-15.
- #3
-
For details about the abbreviations of unit types, see the description of the parameter ty= in 5.2.1 Attribute definition.
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:
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}
|
%St |
[N,][+]hh:mm
|
%sy %ey |
[N,]{hh:mm|Pmmmm}
|
Digit |
Meaning |
value |
---|---|---|
1 |
Sets a set user ID bit and a set group ID bit for a job. |
|
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.
-
Save the unit definition information in all the units.
ajsprint -a /* > c:\temp\winbackup.txt
-
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
-
Save the base time, base day, and month term of AJSROOT.
ajsprint -f"-lt %st -ld %sd -md %md" / > c:\temp\calopt.txt
-
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:
-
ajsdefine c:\temp\winbackup.txt
-
ajscalendar -df c:\temp\rootcal.txt /
-
for /F "tokens=*" %i in (c:\temp\calopt.txt) do ajscalendar %i /
-
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.
-
Save the unit definition information in all the units.
ajsprint -a "/*" > /tmp/unitbackup.txt
-
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
-
Save the base time, base day, and month term of AJSROOT.
ajsprint -f"-lt %st -ld %sd -md %md" / > /tmp/calopt.txt
-
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:
-
ajsdefine /tmp/unitbackup.txt
-
ajscalendar -df /tmp/rootcal.txt /
-
ajscalendar 'cat /tmp/calopt.txt' /
-
ajschange 'cat /tmp/chgopt.txt' /
-
When you save and recover the unit definition information and calendar information according to the above procedure, make sure that none of the jobnets contained in the destination's unit are currently being executed. For this reason, we recommend that you first stop the scheduler service using the jajs_spmd_stop command.
-
Steps 2, 3, and 4 above are intended when all of the following options have been set: the calendar information, base time, base day, treat as, comment, ownership, and group. If any of these options is missing, using the above procedure may cause you to receive inappropriate information or encounter an error during recovery. You should confirm the contents of unit settings and select options to be specified during the recovery procedure. The following describes how to confirm the contents and how to specify options for recovery.
-
Confirm the file specified in step 2 during the saving procedure. If the file contains no output of calendar information, step 2 for recovery is unnecessary.
-
Confirm the file specified in steps 3 and 4 during the saving procedure. If the file's ajscalendar or ajschange command contains no option value setting or contains an initial value, such as a hyphen (-), you must delete the option before moving on to the recovery procedure.
-
-
If a file created during saving is copied to another host and the copied file is recovered, you can copy all the hierarchical levels below the root job group "/".
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?
Example 4
Collect unit definition information files for defined jobnet 1 (/net1), and jobnet 2 (/net2) created by copying jobnet 1. To ensure that no difference is generated when comparing these two files, execute the command with the -s yes option specified for jobnets 1and 2.
The following shows the defined jobnet 1:
ajsprint -F AJSROOT1 -s yes /net1 > C:\temp\net1.txt
- Example of output of relation line information for jobnet 1 when the -s yes option is specified:
: ar=(f=JobA,t=JobB,seq); ar=(f=JobC,t=JobB,seq); ar=(f=JobD,t=JobA,seq); ar=(f=JobD,t=JobC,seq); :
The following shows jobnet 2 created by copying jobnet 1:
ajsprint -F AJSROOT1 -s yes /net2 > C:\temp\net2.txt
- Example of output of relation line information for jobnet 2 when the -s yes option is specified:
: ar=(f=JobA,t=JobB,seq); ar=(f=JobC,t=JobB,seq); ar=(f=JobD,t=JobA,seq); ar=(f=JobD,t=JobC,seq); :
Because the -s yes option is specified, relation line information entries are output in alphabetical order of unit names. Therefore, no difference is generated between jobnets 1 and 2.
- Cautionary note
-
When you collect and compare unit definition information files for two units, confirm that the character set of the scheduler service (value of the AJSCHARCODE environment setting parameter) is the same. If the character set differs, the output order of unit definition information entries might change.