CL Command Reference - SNDJRNE

CL Command List > SNDJRNE Reference

Description:

The Send Journal Entry (SNDJRNE) command is used to write a single journal entry to a specific journal. The entry can contain any information. The user may assign an entry type to the journal entry and may also associate the journal entry with a specified journaled object.

If the journal currently has a state of *STANDBY, then the journal entry will not be deposited unless OVRSTATE(*STANDBY) is specified.

The journal code for the entry is U, which indicates a user-specified journal entry.

Restrictions:

. If an object other than a file is specified, it must be currently journaled to the specified journal. If a file object is specified, it must either be currently journaled to the specified journal or it must have been last journaled to the specified journal.

. The specified journal cannot be a remote journal.

. The specified journal cannot have a journal state of *INACTIVE.


Examples:

Example 1: Forcing Journal Receivers to Auxiliary Storage

SNDJRNE JRN(JRNLA) TYPE(AB) ENTDTA(¡¯PROGRAM COMPLETE¡¯)
FILE(MYLIB/ORDERENT MBR1) FORCE(*YES)

If the journal currently has a journal state of *ACTIVE, this command places a journal entry of type AB (hex C1C2) with the journal entry data ¡¯PROGRAM COMPLETE¡¯ in the current journal receivers attached to journal JRNLA as found by using the library search list. The entry is associated with member MBR1 of file ORDERENT in library MYLIB. The journal receiver is forced to auxiliary storage after the entry has been placed in it.



Example 2: Sending a Journal Entry

SNDJRNE JRN(JRNLA) TYPE(x¡¯C1F1¡¯) OVRSTATE(*STANDBY)

If the journal currently has a journal state of *STANDBY or *ACTIVE, this command places a journal entry of type ¡¯A1¡¯ (hex C1F1) with no journal entry data in the current journal receiver attached to journal JRNLA as found by using the library search list. The entry is not associated with any physical file member.