ajs
- Organization of this page
Format
ajs [[-F service-name |-v monitor -n full-path-jobnet or job-name {-l execution-ID | -m{state|result}}] [-a login-information-file-name]] [-h login-host-name]
Description
Starts JP1/AJS3 - View. You can also specify arguments to perform the following operation:
-
Directly start the Jobnet Monitor window without having to display and operate the Login screen or JP1/AJS3 - View window.
-
Directly start the JP1/AJS3 - View window without having to display and operate the Login screen.
Execution privileges
None
Arguments
-F service-name
Specify the name of the target scheduler service.
You can specify a character string of 1 to 30 bytes.
-v monitor
Specify starting of the Jobnet Monitor window.
You must specify this option with the -n, -l, or -m option.
-n full-path-jobnet or job-name
Specify the full path unit name of the jobnet or job in the scheduler-service-name:/jobnet-name or scheduler-service-name:/job-name format.
You can specify a character string of 1 to 30 bytes for the scheduler service name and a character string of 1 to 930 bytes for the jobnet or job name.
You can also specify the name of a remote jobnet on the destination host in the scheduler-service-name:/remote-jobnet-name format (Example: AJSROOT1:/1042614948234/net07).
If you specify a nested jobnet, the Jobnet Monitor window will display the specified nested jobnet highlighted in the tree area.
If you specify a job, the Jobnet Monitor window will display the jobnet containing the specified job highlighted in the tree area.
You must specify this option with the -v, -l, or -m option.
-l execution-ID
Specify the execution ID (a character string of up to 10 bytes) for the top-level jobnet to be displayed in the Jobnet Monitor window.
You must specify this option with the -v and -n options.
You cannot specify this option with the -m option.
-m {state|result}
Specify whether you want to view the state or result when the Jobnet Monitor window displays the jobnet or job specified with the -n option.
If you specify state, the window displays the current execution state of the jobnet or job, in the same way as when you choose View - Jobnet Monitor - Status in the JP1/AJS3 - View window.
If you specify result, the window displays the current execution results of the jobnet or job, in the same way as when you choose View - Jobnet Monitor - Result in the JP1/AJS3 - View window.
You must specify this option with the -v and -n options.
You cannot specify this option with the -l option.
Note that if today is set for the VIEWSTATUSRANGE environment setting parameter, the status or result of the day's generation is displayed.
-a login-information-file-name
Specify the name of the login information file that defines information necessary for logging in to JP1/AJS3 - Manager (user name, password, and destination host name).
If you specify this option, the system uses the information written in the login information file to log in to JP1/AJS3 - Manager and displays the JP1/AJS3 - View window or Jobnet Monitor window.
If you omit this option, the Login screen appears and, after you log in, the JP1/AJS3 - View window or Jobnet Monitor window appears.
The login information in the file is the same as the information you specify in the Login screen. For details about login information, see 3. Logging in and Logging out of JP1/AJS3 - Manager in the JP1/Automatic Job Management System 3 Operator's Guide.
You can specify a character string of 1 to 255 bytes. For login-information-file-name, you cannot specify the following file names:
-
A file name that includes a space
-
A file name that begins with a hyphen (-)
If you specify a file name containing a space character, the system assumes the characters preceding the space character to be the file name. If you specify a file name containing a hyphen, the system does not recognize the file name and displays the following error message:
KAVV192-E A required parameter is missing.[-a]
You must store the login information file in the following location:
JP1/AJS3 - View-installation-folder\conf\
If the conf directory does not contain the login information file, the following error message appears:
KAVV380-E The login information file (file-name) is not found. Detailed information: detailed-information-1, detailed-information-2
Write the login information file in the following format:
username=login-user-name password=password host=destination-host-name-or-IP-address
Using a dot representation (for example, 100.100.1.1), specify the IP address. The specified IP address must be an IPv4 address. It must not be an IPv6 address.
Each line must end with a line feed character. If you define two or more lines that contain the same keyword, the line defined first takes effect. Any keywords other than username, password, or host are ignored. A line beginning with a hash mark (#) is handled as a comment. The following shows an example:
#This is login information file for job server username=user1 password=user0000 host=apserve
-h login-host-name-or-IP-address
Use this argument to temporarily change the connection-target host at automatic login. Using a dot representation (for example, 100.100.1.1), specify the IP address. The specified IP address must be an IPv4 address. It must not be an IPv6 address.
When the -h option is specified, the system forces you to log in to the specified host. You will log in to the specified host even if the connection-target host name is specified in the login information file indicated by the -a option, or in the automatic login settings in the Environment Settings dialog box. When you specify both the -a option and the -h option as arguments of the startup command, you do not need to specify the connection-destination host name in the login information file.
If you are not performing automatic login by using the login information file indicated by the -a option or the Environment Settings dialog box, specify the default host name shown in the Host to connect text box in the Login screen that appears at startup.
Notes
-
You cannot encrypt or scramble the password described in the login information file. Therefore, be sure to specify user privileges given by the OS to restrict access to the login information file.
The following shows an example of restricting access to the file based on the user privilege:
-
Log in as the machine administrator user (such as Administrators) and choose the Security tab in the Properties dialog box for the login information file.
-
From the Names list, select the users you want to permit or deny access.
-
In the Access permission list, permit or deny access.
If the above steps cause a security problem, do not specify the password keyword. If you do not specify password, the error message KAVV140-E The keyword (keyword-name) is not specified in the login information file (file-name). appears, followed by the Login dialog box. Then, enter the password.
-
-
If you specify the -a option, the system logs in using the information specified in the login information file, ignoring the automatic login function even if you specify Yes for Login - Auto login in the Preferences dialog box for JP1/AJS3 - View.
-
When starting multiple JP1/AJS3 - View hosts continuously, start the next JP1/AJS3 - View host after the JP1/AJS3 - View window of JP1/AJS3 - View previously opened is displayed. If you start the next JP1/AJS3 - View before the previous window opens, the preference information may become invalid.
-
Always separate the option and its value by at least one space character.
-
When you specify the name of the login information file, do not enclose the file name with double quotation marks ("). If you do so, an error message (KAVV380-E The login information file (file-name) is not found. Detailed information: detailed-information-1, detailed-information-2) appears.
Example 1
The following example directly starts the Jobnet Monitor window without displaying and operating the Login screen or the JP1/AJS3 - View window. It uses apserver_login.txt as the login information file and the Jobnet Monitor window will display the current results for the jobnet named AJSROOT1:/GYOUMU_GROUP1/PC_job.
ajs -v monitor -n AJSROOT1:/GYOUMU_GROUP1/PC_job -m result -a apserver_login.txt
Example 2
The following example directly starts the JP1/AJS3 - View window without displaying and operating the Login screen. It uses apserver_login.txt as the login information file.
ajs -a apserver_login.txt