jpqreguser
- Organization of this page
Format 1
jpqreguser [-lh logical-host-name] [-lu user-name] -rh name-of-JP1/OJE-for-VOS3-host-connected -ru user-name-on-JP1/OJE-for-VOS3-host-connected [-rg group-name-on-JP1/OJE-for-VOS3-host]
Description 1
Before starting linkage with JP1/OJE for VOS3, this command registers VOS3 user information in the JP1/AJS3 host from which the job was submitted. It also changes the registered user information.
The users and hosts to be registered vary depending on whether you use JP1/AJS3 - View to execute the QUEUE job or use a command to execute a submit job. For details, see 6.2 Setup for executing QUEUE jobs or submit jobs in the JP1/Automatic Job Management System 3 Linkage Guide.
Format 2
jpqreguser [-lh logical-host-name] [-lu user-name] -d -rh name-of-JP1/OJE-for-VOS3-host-connected
Description 2
Deletes the registered user information.
Format 3
jpqreguser [-lh logical-host-name] -a
Description 3
Lists registered user information.
Execution privileges
-
For executing the command in Format 1 or Format 2 in Windows: Administrators privileges
-
For executing the command with the -lu option specified:
In Windows: Administrators privileges
In UNIX: Superuser privileges
-
In other cases: None
Arguments
-lh logical-host-name
Specify the logical host name of the JP1/AJS3 host in which user information is to be registered.
You can specify 1 to 255 characters (bytes). If you omit this option, the system assumes the local host name.
-lu user-name
Specify the user name that you use to operate JP1/OJE for VOS3 host jobs.
You can specify 1 to 63 characters (bytes).
Specify a JP1 user or OS user. Which type of user you specify depends on the user who requested the job. The type of the user requesting the job varies according to the following cases:
-
When defining and executing a QUEUE job in a jobnet: JP1 user
-
When executing a submit job: OS user
If you omit this option, the system assumes the login user name.
Only those users having Administrators privileges (in Windows) or superuser privileges (in UNIX) can specify this option.
-rh name-of-JP1/OJE-for-VOS3-host-connected
Specify the name of the JP1/OJE for VOS3 host to be connected.
You can specify 1 to 255 characters (bytes).
-ru user-name-on-JP1/OJE-for-VOS3-host-connected
Specify the user name on the JP1/OJE for VOS3 host used to operate a job for the host specified by the -rh option.
You can specify 1 to 32 characters (bytes).
-rg group-name-on-JP1/OJE-for-VOS3-host
Specify the name of the group on JP1/OJE for VOS3 to which the user specified by the -ru option belongs.
You can specify 1 to 32 characters (bytes). If you omit this option, the system assumes that there is no group.
-d
Deletes the registered user information.
If you want to delete information about a user who was specified in the -lu option during registration, you must also specify that user in the -lu option during deletion.
If you want to delete information about the default user (assumed if the -lu option was omitted during registration), you must enter the same password that was specified during registration.
-a
Lists user information.
Notes
-
Do not execute this command if a JP1 series product that requires JP1/Base is running.
-
If you want to submit a job to the JP1/OJE for VOS3 host or delete a submitted job, first register the user information. However, you can reference job information for the JP1/OJE for VOS3 host even if you do not register the user information.
-
Registering, modifying, and deleting user information requires the entry of a password.
-
To register user information, enter the password corresponding to the user on the JP1/OJE for VOS3 host to be connected.
-
To modify user information, enter the password corresponding to the VOS3 user specified at registration. To change the specified VOS3 user to a new VOS3 user, also enter the password corresponding to the new VOS3 user.
-
To delete user information, enter the password corresponding to the VOS3 user specified at registration.
-
No password is required to change or delete user information that was registered with the -lu option specified.
-
You can register only one user name that differs only in whether it uses uppercase or lowercase letters.
For details on restricted values when specifying passwords and other information, see the manual Job Management Partner 1/Open Job Entry Description, User's Guide and Reference, for VOS3 systems.
-
-
Before you execute this command on a computer running Windows, make sure that you open the Command Prompt window as an administrator. If the UAC function is disabled, you do not need to open the Command Prompt window as an administrator.
- Notes on operating a cluster system
-
To operate a cluster system, you must set user information on both the executing host and standby host. If you add, change, or delete user information on the executing host, you must also add, change, or delete user information on the standby host.
To add, change, or delete user information on the standby host:
-
Execute the following command on the executing host to save the definition information.
jbsgetcnf -h logical-host-name > definition-information-file-name
For details on the jbsgetcnf command, see the JP1/Base User's Guide.
-
Execute the following command on the standby host to save the definition information as a backup.
jbsgetcnf -h logical-host-name > backup-file-name
-
Execute the following command on the standby host to delete the registered user information.
jbsunsetcnf -h logical-host-name -c JP1NBQCLIENT -n Profile
For details on the jbsunsetcnf command, see the JP1/Base User's Guide.
-
Using the definition information file you saved in step 1, execute the following command on the standby host.
jbssetcnf definition-information-file-saved-in-step-1
For details on the jbssetcnf command, see the JP1/Base User's Guide.
-
Restart JP1/AJS3 on the standby host.
The contents of the definition information file are applied to the system.
-
Return values
0 |
Normal end |
1 |
The specified argument is invalid. |
160 |
You attempted to delete unregistered user information. |
165 |
On a target host that is running Windows, a user without administrator privileges attempted to execute the command in Format 1 or Format 2. |
166 |
The system cannot update or delete user information because the entered password does not match the registered password. |
170 |
There is insufficient memory. |
171 |
You do not have the privilege (are not authorized) to execute this command. |
172 |
An internal factor error occurred. |