C5 Command (Write User Data to Protection Log)

#### Search Results

Search

# C5 Command (Write User Data to Protection Log)

This document covers the following topics:

- Function and Use

- Control Block

- Record Buffer

- Example

## Function and Use

The C5 command is used to write user data to the Adabas protection log.

The data written have no effect on Adabas recovery processing. The recovery utility ADAREC ignores all data written to the data protection log as a result of a C5 command.

##### C5 Command, Procedure Flow

### Control Block

Field | Format |
--- | --- | ---
Call Type | B | F/U
Reserved (internal use) |  | -/-
Command Code | A | F/U
Command ID | B | -/-
File Number | B | F/U (1)
Response Code | B | F/A (1)
Record Buffer Length (ACB only) | B | F/U
Additions 2 | A,B | -/A
Command Time | B | -/A
User Area |  | F/U

### Buffer Areas

Buffer |
--- | ---
Format Buffer | */–
Record Buffer | F/U
Search Buffer | –/–
Value Buffer | –/–
ISN Buffer | –/–

> Formats:

>   A | alphanumeric
>   B | binary

> x/y before/after Ababas call - x and y can take the values:

>   A | Filled in by Adabas
>   F | To be filled in by User
>   U | Unchanged after Adabas call
>   - | Not used
>   * | Not used but must be included in parameter list of CALL statement

>   (1) The meaning of this field depends on the value specified for "Call Type". See Calling Adabas, The Control Block for details.

## Control Block

> Command Code

>   C5

> Response Code

>   Adabas returns the response code for the command in this field. Response code 0 indicates that the command was executed successfully.

> Record Buffer Length (ACB only)

>   The number of bytes specified in this field will be written to the Adabas data protection log.

>   The maximum length which may be specified is 2000 bytes.

> Additions 2

>   For some response codes, Adabas returns detailed information in this field. See Adabas Messages and Codes for further information.

## Record Buffer

The information to be written to the data protection log is provided in this buffer.

The format of the data protection log is alphanumeric.

## Example

The information 'ULRR0422 UPDATES FOR JANUARY' is to be written to the Adabas data protection log.

#### Control Block

    Command Code          C5

    Record Buffer Length  28

#### Buffer Areas

    Record Buffer         ULRR0422 UPDATES FOR JANUARY

### On this page

- Function and Use
- Control Block
- Record Buffer
- Example