jbslistuser

Organization of this page

Function
Format
Required execution permission
Command directory
Arguments
Notes
Return values
Example

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 be specified in Windows only.

To Page Top

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 or JP1/Base administrator permission

To Page Top

Command directory

In Windows:: installation-folder\bin\
In UNIX:: /opt/jp1base/bin/

To Page Top

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 be specified in Windows only.

When this option is specified, only the linked users are displayed.

To Page Top

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.

To Page Top

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
`32`	An error occurred while initializing the communication functionality.
`128`	Inconsistency in internal processing (a C++ exception)
`255`	Other error

To Page Top

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:

[Figure]

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.

To Page Top