FEPI INSTALL PROPERTYSET

Function

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

Syntax

Read syntax diagramSkip visual syntax diagramFEPI INSTALL PROPERTYSET
 
>>-FEPI INSTALL--PROPERTYSET(data-value)------------------------>
 
                                 .-LOSE-------------.
>--+--------------------------+--+------------------+----------->
   '-BEGINSESSION(data-value)-'  +-CONTENTION(cvda)-+
                                 '-WIN--------------'
 
   .-T3278M2------.
>--+--------------+--+------------------------+----------------->
   +-DEVICE(cvda)-+  '-ENDSESSION(data-value)-'
   +-T3278M3------+
   +-T3278M4------+
   +-T3278M5------+
   +-T3279M2------+
   +-T3279M3------+
   +-T3279M4------+
   +-T3279M5------+
   +-TPS55M2------+
   +-TPS55M3------+
   +-TPS55M4------+
   '-LUP----------'
 
>--+------------------------+--+--------------------------+----->
   '-EXCEPTIONQ(data-value)-'  +-FJOURNALNAME(data-value)-+
                               '-FJOURNALNUM(data-value)--'
 
   .-FORMATTED----.  .-NOTINBOUND--------.
>--+--------------+--+-------------------+---------------------->
   +-FORMAT(cvda)-+  +-INITIALDATA(cvda)-+
   '-DATASTREAM---'  '-INBOUND-----------'
 
                               .-NOMSGJRNL-----.
>--+------------------------+--+---------------+---------------->
   '-MAXFLENGTH(data-value)-'  +-MSGJRNL(cvda)-+
                               +-INPUT---------+
                               +-OUTPUT--------+
                               '-INOUT---------'
 
>--+------------------+----------------------------------------->
   '-STSN(data-value)-'
 
>--+---------------------------------------------+-------------><
   |                       .-NEGATIVE----------. |
   '-UNSOLDATA(data-value)-+-UNSOLDATACK(cvda)-+-'
                           '-POSITIVE----------'
 

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 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

Condition RESP2 Meaning
INVREQ 140 DEVICE value not valid.
INVREQ 141 CONTENTION value not valid.
INVREQ 142 INITIALDATA value not valid.
INVREQ 143 UNSOLDATACK value not valid.
INVREQ 144 MSGJRNL value not valid.
INVREQ 150 FORMAT value not valid or is unsuitable for the LU mode and device type specified by the DEVICE value.
INVREQ 153 STSN name not valid or STSN is not allowed for the LU mode and device type specified by the DEVICE value.
INVREQ 154 BEGINSESSION name not valid.
INVREQ 155 UNSOLDATA name not valid.
INVREQ 156 EXCEPTIONQ name not valid.
INVREQ 157 FJOURNALNUM value not valid.
INVREQ 158 MAXFLENGTH value not valid.
INVREQ 159 ENDSESSION name not valid.
INVREQ 160 PROPERTYSET name not valid.
INVREQ 170 PROPERTYSET name already exists.
INVREQ 178 FJOURNALNAME value not valid.
[[ Contents Previous Page | Next Page Index ]]