login

General Purpose

This service creates a new session for using X-Services.

The service returns a session id that can be used to run other X-Services. To improve the efficiency of the X-Service currently, add a parameter session={the session retrieved by the login service}.

Input Parameters

1. LIBRARY – PICTURE X(5).
2. USER_NAME – PICTURE X(10).
3. USER_PASSWORD – PICTURE X(20).

  • LIBRARY: The library code.
  • USER_NAME: A staff user name from the Z66 table.
  • USER_PASSWORD: The staff password from the Z66 table.

Output XML Format

The output XML includes the new session ID that has been created.

Example:
To log in as the user dtl02 to the dat01 library, enter the following URL:

http://ram7:8175/X?op=login&library=dat01&user_name=yyy&user_password=zzz

If successful, the output XML includes the session ID:

<login>
#60;session-id>AR5ANXH8S7VCVHG79NK87HBHJ6H8XY9VD348ABGLQRS4BHNV9I</session-id>
</login>

Possible Error Codes

1. If the login X-Service is activated without a library having been entered, the following message appears in the output XML:

<error>Missing library</error>

2. If the login X-Service is activated without user_name having been entered:

<error>Missing username</error>

3. If the login X-Service is activated without user_password having been entered:

<error>Missing password</error>

4. If an invalid user_name (user that does not exist in the Z66 table) is entered, for example, DTL:

<error>User name DTL does not exist</error>

5. If an invalid user_password (password that does not exist in the Z66 table) is entered:

<error>Error in password for user name DTL02</error>