Profile definition attributes

The profile definition attribute descriptions are:

Chaincontrol
specifies whether the application program can control the outbound chaining of request units. If you specify CHAINCONTROL(YES), ONEWTE(YES) means one chain and not one terminal control output request.
Description
(Optional.) Specifies a 1- to 30-character description of the resource.
Dvsuprt
specifies the devices (terminals or logical units) that are to be supported.
ALL
The profile can be used with any terminal or logical unit.
NONVTAM
The profile can be used only with non-VTAM terminals.
VTAM
The profile can be used only with logical units.
Facilitylike
For systems running CICS® TS for OS/390 Release 2 and later, identifies the 1- to 4-character name of a terminal definition or an installed terminal definition (TERMDEF) to be used as a template by a bridge exit. When this transaction is run in a 3270 bridge environment, the principal facility will be built to have the same attributes as the terminal defined by the Facilitylike field.

There is no default value for this attribute.

If you are running in a CICS system started with the VTAM=NO system initialization (SIT) parameter, the resource definition specified by Facilitylike must be defined as a remote terminal.

Inbfmh (SNA LUs only)
specifies, for profiles used with logical units, whether a function management header (FMH) received from a logical unit is to be passed to the application program.
ALL
All FMHs (except APPC FMHs and LU6.1 ATTACH and SYNCPOINT FMHs that are processed by CICS) are passed to the application program. This value is required for function shipping transactions such as CSMI, transactions which use distributed transaction processing, and for distributed program link requests.
DIP
The batch data interchange program (DFHDIP) is to process inbound FMHs.
EODS
An FMH is passed to the application program only if it indicates end of data set (EODS).
NO
The FMHs are discarded.
Journal
specifies that you want automatic journaling of messages to take place, by giving the identifier of the journal.
NO
No automatic journaling of messages is to take place.
number
The journal identification to be used for automatic journaling. This can be any number in the range 01 through 99. This number is appended to the letters DFHJ to give a journal identification of the form DFHJnn and this maps to an MVS™ system logger general log stream.
Note:
In CICS Transaction Server for OS/390®, Version 1 Release 1, and subsequent releases, DFHJ01 is not the system log.
Logrec
specifies whether the design of the application requires that each EXEC CICS RECEIVE request is to be satisfied by a logical record.
Modename
specifies the name that identifies a group of sessions for use on an APPC connection. The name can be up to eight characters in length.
Msginteg (SNA LUs only)
specifies whether a definite response is to be requested with an output request to a logical unit.
Msgjrnl
specifies which messages are to be automatically journaled.
NO
No message journaling is required.
INPUT
Journaling is required for input messages.
OUTPUT
Journaling is to be performed for output messages.
INOUT
Journaling is to be performed for input and output messages.
Name
Specify a 1- to 8-character name for the profile definition.
Nepclass (VTAM only)
specifies the node error program transaction class.
0
This results in a link to the default node error program module for VTAM devices, or is the default value for non-VTAM devices.
value
The transaction class for the (nondefault) node error program module. The value can be in the range 1 through 255. For programming information on the node error program, see the CICS Customization Guide.
Onewte
specifies whether the transaction is permitted only one write operation or EXEC CICS SEND during its execution. YES has the effect of forcing the LAST option on the first write of the transaction. Any additional write requests are treated as errors, and the task is made ready for abnormal termination.
Printercomp
specifies the level of compatibility required for the generation of data streams to support the printer compatibility option for the BMS SEND TEXT command.
NO
Each line of output starts with a blank character, so that the format is equivalent to that on a 3270 display where an attribute byte precedes each line.
YES
No blank character is inserted, so that forms-feed characters included as the first character of your data are honored and the full width of the printer is available for your data.

If you use the BMS forms feed option, specify YES.

Protect
For SNA logical units, specify YES or NO to indicate whether recovery for output messages is required. If the Protect value does not apply to this definition, specify N/A.
Raq (SNA terminals only)
specifies whether the ‘read ahead queuing’ option is required.
NO
The transaction obeys SNA protocols and only SEND and RECEIVE when in the correct mode. If it does not follow the protocol, it may be abended with code ATCV.
YES
The transaction may not obey SNA protocols, and CICS queues incoming data on temporary storage until the data is specifically requested by the transaction. RAQ(YES) is provided only for compatibility with transactions that support both bisynchronous devices and logical units, and its use is not recommended.
RESGROUP
(Optional.) Specify the name of an existing resource group to which the definition is to be automatically added.
Rtimout
specifies the time-out value:

RTIMOUT has no effect for MRO or basic (unmapped) APPC connections.

NO
The read time-out feature is not required.
value
This is an interval (MMSS for minutes and seconds) after which the task is terminated if no input has been received from the terminal. The maximum value that can be specified is 70 minutes. The value specified in this option is rounded up to units of 16.78 seconds. Thus, the minimum value (after rounding-up) is 16.78 seconds.

If you leave this field blank, CICSPlex® SM uses the default value for your CICS environment, if there is one.

Scrnsize
specifies whether the DEFAULT or ALTERNATE buffer size for a 3270 display or printer is to be used.

The SCRNSIZE value is ignored if the TYPETERM definition has ALTSCREEN(0,0) and DEFSCREEN(0,0). That is, the screen size is assumed from the related TERMMODEL attribute in the TYPETERM definition; the page size is taken from PAGESIZE, and the ALTPAGE value is ignored. The 3270 erase write (EW) command is inserted for output requests with the ERASE option.

ALTERNATE
If the TYPETERM definition has nonzero ALTSCREEN, the alternate screen size mode is applied, using the erase write alternate (EWA) command. That is, whenever a terminal output request with the ERASE option is issued, the 3270 EWA command is inserted in the data stream. The ALTSCREEN value is assumed as the screen size, and BMS uses the value in ALTPAGE as the page size.

SCRNSIZE(ALTERNATE) may be used for all CICS service transactions (for example, CSMT).

DEFAULT
If the TYPETERM definition has nonzero ALTSCREEN or nonzero DEFSCREEN, the default screen size mode is applied, using the erase write (EW) command. That is, whenever the terminal issues a terminal output request with the ERASE option, the 3270 EW command is inserted in the data stream. The screen size specified in the DEFSCREEN attribute is assumed, and BMS uses the value specified in the PAGESIZE attribute as the page size.
Uctran (VTAM only)
specifies whether terminal input is to be translated to uppercase before passing to programs for the transaction using this profile.
User Data
(Optional.) Three 8-character fields provided for any site-specific data related to the profile. CICSPlex SM makes no use of this user data.
Version
(Optional.) Specify an integer in the range 1 through 15. Specify 0 or leave blank for CICSPlex SM to assign the first available version id in the range 1 through 15.

Related concepts
Profile resource definitions
CICS Resource Definition Guide
Related tasks
Accessing BAS profile resource definitions
Working with the PROFDEF view
Defining profiles using BAS
Installing BAS profile definitions
[[ Contents Previous Page | Next Page Index ]]