server task file cat

Syntax

server task server_name file cat file_name byte_offset [-max bytes] [-encode]

Options

server_name

Specifies the name of the Verify Identity Access authorization server on which the file is hosted.

file_name

Specifies the fully qualified name of the file which is to be retrieved.

byte_offset

Specifies the offset in bytes from the start of the file at which the data is retrieved.

-max bytes

Specifies the maximum number of bytes to be returned from the file. If you do not specify this parameter, the maximum number of bytes returned is controlled by the max-file-cat-command-length value in the [server] stanza. The max-file-cat-command-length value takes precedence over the -max bytes value. If the specified file is larger than the max-file-cat-command-length value, the returned data is truncated.

--encode

Designates that the contents of the file must be base-64 encoded before it is returned. (Optional)

Authorization

Users and groups that require access to this command must have the s (administration) permission in the ACL that governs the /WebSEAL/host_name-instance_name object. For example, the sec_master administrative user has this permission by default.

Return codes

0

The command completed successfully. For WebSEAL server task commands, the return code is 0 when the command is sent to the WebSEAL server without errors. However, even after the command was successfully sent, the WebSEAL server might not successfully complete the command. The WebSEAL server returns an error message.

1

The command failed. When a command fails, the pdadmin command provides a description of the error and an error status code in hexadecimal format, for example, 0x14c012f2. See "Error messages" in the IBM Knowledge Center for a list of the Verify Identity Access error messages by decimal or hexadecimal codes.