ajsname
- Organization of this page
Format
ajsname
[-F service-name]
[-V]
[-R]
[{-L|-E}]
[-T]
[{-G|-N|-J}]
[-I]
job-name-or-jobnet-name-or-job-group-name...
Description
Outputs a unit name 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.
-V
Does not output unit names in remote jobnets.
-R
Outputs all the unit names in a specified unit.
If you specify this option with the -L, -E, -T, -G, -N, and/or -J options, the system outputs the unit names according to the specification of each option.
-L
Outputs the names of the jobnets not registered for execution.
You cannot specify this option with the -E or -G option.
-E
Outputs the names of the jobnets registered for execution.
You cannot specify this option with the -L or -G option.
-T
Outputs the root jobnet name.
You cannot specify this option with the -G or -J option.
-G
Outputs a job group name.
You cannot specify this option with the -L, -E, -T, -N, or -J option.
-N
Outputs a jobnet name.
You cannot specify this option with the -G or -J option.
-J
Outputs a job name.
You cannot specify this option with the -T, -G, or -N option.
-I
Specify this option during troubleshooting to output the full unit name by specifying the unit ID that is output in an error message. Do not use the option other than for troubleshooting.
You cannot specify this option together with the -V, -R, -E, -L, -T, -G, -N, or -J 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 to the standard output file. You can also specify a job name, jobnet name, or job group name with the -R, -L, -E, -T, -G, -N, or -J option.
You can specify a character string of 1 to 930 bytes.
You can specify more than one job name, jobnet name or job group name.
You cannot specify a logical host name or execution ID as a job, jobnet or job group name.
When specifying the -I option, specify the unit ID in decimal notation (do not specify the unit name).
Notes
-
Either of the following users can output a unit name:
-
A user granted the reference privilege when the units contained in the unit were defined or when their attributes were defined
-
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.
-
-
If the command is executed for a release target jobnet (root jobnet for which release entry is made), the unit names in the jobnet definitions in Being applied status are output.
Return values
|
0 |
Normal end |
|
Multiple of 4 within the range from 4 to 124 |
Abnormal end |
Example1
The following command outputs all the job names in the jobnet /GRP/net1 to the standard output file.
ajsname -RJ /GRP/net1
- Output example 1
/GRP/net1/job1 /GRP/net1/job2 /GRP/net1/n1/job /GRP/net1/n2/job
Example2
The following command outputs the full name of a unit whose unit ID is 10:
ajsname -I 10
- Output example 2
/group