Hitachi

JP1 Version 12 JP1/Automatic Job Management System 3 Command Reference


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:

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:

[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 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:

    1. Entries are output in ascending order of the character codes of the preceding unit names.

    2. 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

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

Table 3‒13: 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, 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.

Example:

[[Unix-job-for-recovery-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, 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.

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

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.

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

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

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, 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

  • GET

  • POST

  • PUT

  • DELETE

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.

Table 3‒14: 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 3‒15: 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 3‒16: 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' /

  • 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:

[Figure]

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:

[Figure]

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.