ajscon
- Organization of this page
Format
ajscon [-bmd] [-a login-information-file-name] [-h login-host-name]
Description
Starts the JP1/AJS3 Console View.
Execution privileges
None
Storage directory
JP1/AJS3 - View-installation-folder\bin\
Arguments
-bmd
Sets the definition mode for the starting mode. If the definition mode cannot be used because another process is currently monitoring, the system displays an error message and enters the monitor mode.
If you do not specify this option, JP1/AJS3 Console View is started in the monitor mode.
-a login-information-file-name
Specify the name of the login information file that defines information necessary for logging in to JP1/AJS3 Console Manager (user name, password, and destination host name).
With this option specified, you can log in automatically without displaying the Login screen.
If automatic login is specified in the Preferences dialog box of JP1/AJS3 Console View, the information defined in the specified login information file takes precedence.
You can specify a character string of 1 to 255 bytes. The login information file name cannot contain the following characters:
-
Space character
-
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 JP1/AJS3 Console View terminates with the following error message:
KAVC4013-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, JP1/AJS3 Console View terminates with the following error message appears: KAVC4020-E The login information file (file-name) is not found.
Describe the login information file in the following format:
username=login-user-name password=password host=destination-host-name
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
Use this argument to temporarily change the connection-destination host at automatic login.
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
-
Set up JP1/AJS3 Console View before executing this command.
-
Do not enclose the login information file name in double quotation marks ("). Otherwise, an error message KAVC4020-E appears.
-
Always separate an option and its value by at least one space character.
-
For details about setting the access restrictions on the login information file, see Notes in the description of the ajs in 2. Commands in the manual Job Management Partner 1/Automatic Job Management System 3 Command Reference 1.
Return values
0 |
Normal end |
Other than 0 |
Abnormal end |