jpqregguestuser
- Organization of this page
Format
jpqregguestuser
[-lh logical-host-name] [{-lu user-name|-d}]
Description
When using the assumed JP1 user function, you can use this command to register only one JP1 assumed user in the specified manager host. You can also use this command to display information for the registered assumed-JP1 user.
To reflect the contents set by this command, you must restart JP1/AJS3 after executing this command.
Execution privileges
In Windows: Administrators privileges
In UNIX: Superuser privileges
Arguments
-lh logical-host-name
Specify the name of the logical host for the manager host on which the assumed-JP1-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 name of the assumed JP1 user using lowercase letters.
You can specify 1 to 31 characters (bytes).
If you omit this option, the system does not register the information for the assumed JP1 user. At this time, if a JP1 user has already been assumed, the following message is output to the standard output: KAVU0819-I Assumed JP1 user (assumed-JP1-user-name) is registered.
If the name of the JP1 user to be newly assumed is the same as that of the JP1 user that is already assumed, the information for the JP1 user being newly assumed overwrites that of the JP1 user that is already assumed.
-d
Deletes the information for the registered assumed JP1 user.
Specifying this option makes it impossible to use the assumed JP1 user function.
Notes
-
Do not execute this command if a JP1 series product that requires JP1/Base is running.
-
Specify a JP1 user name in lowercase letters. Note that uppercase letters are registered as lowercase letters. Registering JP1 user names in lowercase letters causes the information for that JP1 user to be newly assumed, after which the information for the currently assumed JP1 user is overwritten if his or her name is the same as that of the newly assumed JP1 user.
-
To use the assumed JP1 user function, register the assumed JP1 user specified by this command in the user mapping. You must also register this user in the agent host that executes jobs. Set a user privilege level for the operation that you want to perform.
-
For details about the purpose, usage procedure, and other notes for the command, see 7.1.6 Setting the assumed JP1 user function in the JP1/Automatic Job Management System 3 System Design (Configuration) Guide.
Return values
|
0 |
Normal end |
|
1 |
The specified argument is invalid. |
|
140 |
You do not have the privilege (are not authorized) to execute this command. |
|
145 |
There is insufficient memory. |
|
147 |
An internal factor error occurred. |
|
160 |
You attempted to delete assumed JP1 user information that is not registered. |
|
172 |
The status in which the assumed JP1 user is registered is invalid. |
Additional information
Only the commands provided by JP1/AJS3 job execution control can assume JP1 users as a result of executing this command.
Registering a user as the assumed JP1 user allows even those even those OS users who are not registered as JP1 users to operate JP1/AJS3 using the assumed JP1 user privilege. If the OS user is registered as a JP1 user, use the JP1 user.