Job Management Partner 1/Base User's Guide

jbslistuser

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.

[Contents][Back][Next]

[Trademarks]

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