FEPI INSTALL PROPERTYSET

Define a new set of properties.

FEPI INSTALL PROPERTYSET

Notes:

Description

FEPI INSTALL PROPERTYSET defines a new set of properties to FEPI, which can be applied to any subsequently defined pool.

Options

Note: Specifying a blank value for BEGINSESSION, ENDSESSION, EXCEPTIONQ, STSN, or UNSOLDATA has the same effect as omitting the option.

BEGINSESSION(4-character data-value)

specifies the name of the transaction to perform begin-session processing, immediately after a session has been established (bound). If omitted, there is to be no user-supplied begin-session processing.

CONTENTION(cvda)

specifies what happens when a FEPI SEND command is issued and there is inbound data with begin-bracket. The relevant CVDA values are:

LOSE: The FEPI SEND command fails; a FEPI RECEIVE must be issued to get the inbound data.
WIN: The FEPI SEND command succeeds; inbound data is rejected with a negative response.

DEVICE(cvda)

specifies the LU mode and device type that is to be simulated. The relevant CVDA values are:

T3278M2: SLU2 mode, 3278 Model 2
T3278M3: SLU2 mode, 3278 Model 3
T3278M4: SLU2 mode, 3278 Model 4
T3278M5: SLU2 mode, 3278 Model 5
T3279M2: SLU2 mode, 3279 Model 2B
T3279M3: SLU2 mode, 3279 Model 3B
T3279M4: SLU2 mode, 3279 Model 4B
T3279M5: SLU2 mode, 3279 Model 5B
TPS55M2: SLU2 mode, PS/55, 24 lines
TPS55M3: SLU2 mode, PS/55, 32 lines
TPS55M4: SLU2 mode, PS/55, 43 lines
LUP: SLU P mode, all cases.

ENDSESSION(4-character data-value)

specifies the name of the transaction to perform end-session processing, when a conversation is ended (by a FEPI FREE command) or when a session is to be ended (unbound). If omitted, there is to be no user-supplied end-session processing.

EXCEPTIONQ(4-character data-value)

specifies the name of the TD queue to which pool-specific exceptional events are to be notified. If EXCEPTIONQ is omitted, there is to be no user-supplied exceptional event processing.

FJOURNALNAME(8-character data-value)

specifies the 1- to 8-character name of the journal where data is to be logged. You are not permitted to specify DFHLOG or DFHSHUNT, the primary and secondary system logs. If the value is zero or omitted, no journaling is done.

FJOURNALNUM(fullword binary data-value)

specifies the number of the journal where data is to be logged, in the range 1 through 99. Specifying a value here implies the journal name DFHJnn, where nn is the journal number. If the value is zero or omitted, no journaling is done.

FORMAT(cvda)

specifies, for SLU2 mode, the data mode to be used. The relevant CVDA values are:

FORMATTED: Formatted operation. Character attributes are not supported on outbound data and ignored on inbound data.
DATASTREAM: Data stream operation.

This option is not valid for SLU P operation.

INITIALDATA(cvda)

specifies whether initial inbound data is expected when a session is started. The relevant CVDA values are:

NOTINBOUND: No inbound data is expected.
INBOUND: Inbound data is expected.

If the target is a back-end IMS system, you should specify INBOUND. See FEPI programming: Begin-session handler.

MAXFLENGTH(fullword binary data-value)

specifies the maximum length of data that can be returned on any FEPI RECEIVE, CONVERSE, or EXTRACT FIELD command for a conversation, or that can be sent by any FEPI SEND or CONVERSE command for a conversation. This value helps FEPI use storage more efficiently, so should be set no larger than is necessary. It must be in the range 128–1 048 576. If MAXFLENGTH is not specified, 4096 is used.

MSGJRNL(cvda)

specifies the required journaling of data to and from the back-end system. The relevant CVDA values are:

NOMSGJRNL: No journaling
INPUT: Journal inbound data
OUTPUT: Journal outbound data
INOUT: Journal inbound and outbound data.

PROPERTYSET(8-character data-value)

specifies the name of the set of properties to be defined. The name must not contain null characters (X'00'), leading blanks, or embedded blanks.

STSN(4-character data-value)

specifies the name of the transaction to be started to handle set and test sequence number (STSN), for SLU P mode only. If omitted, there is to be no user-supplied STSN-handling; FEPI handles STSN automatically.

UNSOLDATA(4-character data-value)

specifies the name of the transaction to handle unsolicited data (data received outside a conversation). If omitted, there is to be no user-supplied unsolicited-data processing; FEPI treats unsolicited data as specified by UNSOLDATACK.

UNSOLDATACK(cvda)

if there is to be no unsolicited-data processing, this specifies what acknowledgment FEPI is to give to a BID. The relevant CVDA values are:

NEGATIVE: Negative response X'0813', BID not accepted
POSITIVE: Positive response, BID accepted and subsequent data is accepted and discarded.

Conditions

INVREQ

RESP2 values:

11: FEPI not installed or not active.
140: DEVICE value not valid.
141: CONTENTION value not valid.
142: INITIALDATA value not valid.
143: UNSOLDATACK value not valid.
144: MSGJRNL value not valid.
150: FORMAT value not valid or is unsuitable for the LU mode and device type specified by the DEVICE value.
153: STSN name not valid or STSN is not allowed for the LU mode and device type specified by the DEVICE value.
154: BEGINSESSION name not valid.
155: UNSOLDATA name not valid.
156: EXCEPTIONQ name not valid.
157: FJOURNALNUM value not valid.
158: MAXFLENGTH value not valid.
159: ENDSESSION name not valid.
160: PROPERTYSET name not valid.
170: PROPERTYSET name already exists.
178: FJOURNALNAME value not valid.