The C5 command writes user data on SIBA/PLOG.
This document covers the following topics:
The C5 command is used to write user data to the Adabas data protection log. This data may be read and displayed using the ADASEL utility. The data that is written has no effect on Adabas recovery processing. The ADASAV and ADARES utilities ignore all data written to the data protection log as a result of a C5 command.
| Field | Position | Format | Before Adabas Call | After Adabas Call |
|---|---|---|---|---|
| 1-2 | -- | -- | -- | |
| COMMAND CODE | 3-4 | alphanumeric | F | U |
| 5-8 | -- | -- | -- | |
| FILE NUMBER** | 9-10 | binary | F | U |
| RESPONSE CODE | 11-12 | binary | -- | A |
| 13-26 | -- | -- | -- | |
| RECORD BUFFER LENGTH | 27-28 | binary | F | U |
| 29-34 | -- | -- | -- | |
| COMMAND OPTION 1*** | 35 | alphanumeric | F | U |
| 36 | -- | -- | -- | |
| ADDITIONS 1*** | 37-44 | alphanumeric | F | U |
| 45-72 | -- | -- | -- | |
| COMMAND TIME | 73-76 | binary | -- | A |
| USER AREA | 77-80 | -- | -- | U |
| Buffer | Before Adabas Call | After Adabas Call |
|---|---|---|
| FORMAT BUFFER | * | |
| RECORD BUFFER | F | U |
where:
| F | Filled in by user before Adabas Call |
| A | Filled in by Adabas |
| U | Unchanged after Adabas call |
| * | Not used but must be included in parameter list of call statement |
| ** | A database ID is only necessary if you are
accessing multiple databases and need to limit the command operation to a
specific database.
However, if you are using Event Replicator for Adabas and the Command Option 1 field is set to "R", a file number must be specified to identify the file to which the C5 command applies. For more information, read your Event Replicator for Adabas documentation. |
| *** | Only used if you are using Event Replicator for Adabas. For more information, read your Event Replicator for Adabas documentation. |
| -- | Not used |
C5
A database ID is only necessary if you are accessing multiple databases and need to limit the command operation to a specific database.
However, if you are using Event Replicator for Adabas and the Command Option 1 field is set to "R", a file number must be specified to identify the file to which the C5 command applies. For more information, read your Event Replicator for Adabas documentation.
Adabas returns the response code for the command in this field. Response code 0 indicates that the command was executed successfully. If the C5 command returns a non-zero response code, the rightmost two bytes of the Adabas control block, bytes 45-48 (additions 2 field) may contain a subcode defining the exact response code meaning. Response codes and their subcodes are defined in the Adabas Messages and Codes documentation.
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 2048 bytes.
Used only if you are using the Event Replicator for Adabas. Otherwise, this field must be blank. For more information, read your Event Replicator for Adabas documentation.
Used only if you are using the Event Replicator for Adabas. For more information, read your Event Replicator for Adabas documentation.
The information to be written to the data protection log is provided in this buffer.
The information written may be selected subsequently using the ADASEL utility by specifying the beginning characters (1 to 30 characters) as originally contained in the record buffer. It is, therefore, recommended that the user provide a unique identification of his data in the beginning positions of the record buffer. This will ensure that the user data can be properly identified and selected.
The information "ULRR0422 UPDATES FOR JANUARY" is to be written to the Adabas data protection log.
| Command Code | C5 |
|---|---|
| Record Buffer Length | 28 |
| Record Buffer | ULRR0422 UPDATES FOR JANUARY |
|---|
