C5 Command (Write User Data to Protection Log)

This document covers the following topics:


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.

graphics/c5.png

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