Job Management Partner 1/Base User's Guide
Function
The jbslistuser command lists the registered JP1 users.
Format
jbslistuser [-h logical-host-name] [-s authentication-server-name] [-ld] [-ds#]
- #: The -ds option can only be specified in Windows (except Windows Vista).
Required execution permission
In Windows: Administrators (If User Account Control (UAC) for Windows is enabled, you must execute the command from the administrator console.)
In UNIX: Superuser
Command directory
- In Windows:
- installation-folder\bin\
- In UNIX:
- /opt/jp1base/bin/
Arguments
-h logical-host-name
When using JP1/Base in a cluster system, specify the logical host for which you want to execute this command. The command lists the JP1 users registered on the authentication servers set for this logical host.
-s authentication-server-name
Specify an authentication server to list the JP1 users registered on that authentication server. When you set this option, the -h option is ignored.
-ld
This option enables you to output the date and time at which user data was last modified for each user (yyyy/mm/dd HH:MM:SS format). The last modified date and time is updated when a JP1 user was registered or a password was changed. Note that the last modified date and time for a JP1 user, who was registered before upgrading to JP1/Base Version 8, who was initialized when installing JP1/Base for the first time, or who has been set as a linkage user, is displayed by using hyphens (----/--/-- --:--:--). After a password is changed in the JP1/Base Environment Settings dialog box or by using the password change command (jbschgpasswd), the last modified data and time is displayed.
If you specify the -ds option, this option is ignored.
-ds
This option can only be specified in Windows (except Windows Vista).
When this option is specified, only the linked users are displayed.
Notes
- The -s option takes precedence if you specify both the -h and -s options. If you omit both options, the host name set in the environment variable JP1_HOSTNAME is assumed as the logical host. If you omit both options and nothing is set in JP1_HOSTNAME, the command lists the JP1 users registered on the authentication server(s) set for the physical host.
- The -ds option takes precedence if both the -ld and the -ds options are specified.
Return values
0 Normal end 1 The user is not registered in the authentication server. 2 Invalid arguments 4 Insufficient system resource such as memory 8 The authentication server has not started or is not responding 16 An error occurred in the authentication server side processing 128 Inconsistency in internal processing (a C++ exception) 255 Other error
Example
The following shows examples of output where the standard users jp1admin, jp1admin2 and the linked user testuser1 have been registered on the authentication server:
- When no option is specified:
>jbslistuser jp1user account[0]:jp1admin jp1user account[1]:jp1admin2 jp1user account[2]:testuser1 Successful.
- When the -ld option is specified:
- When the -ds option is specified:
>jbslistuser -ds jp1user account[0]:testuser1 Successful.The following shows an example of output where the standard users jp1admin and jp1admin2 and no linked users have been registered on the authentication server:
- When the -ds option is specified:
>jbslistuser -ds No jp1user account. Failed.
All Rights Reserved. Copyright (C) 2009, Hitachi, Ltd.