Create CICS Map (CRTCICSMAP)

Parameters

Keyword	Description	Choices	Notes
CICSMAP	Map object name	Qualified object name	Required, Positional 1
	Qualifier 1: Map object name	Name
	Qualifier 2: Library	Name, *CURLIB
SRCFILE	Map source file	Qualified object name	Optional, Positional 2
	Qualifier 1: Map source file	Name, QMAPSRC
	Qualifier 2: Library	Name, LIBL, CURLIB
SRCMBR	Map source member name	Name, *MAP	Optional, Positional 3
LMAPSRC	Symbolic map source file	Qualified object name	Optional, Positional 4
	Qualifier 1: Symbolic map source file	Name, *DEFAULT
	Qualifier 2: Library	Name, LIBL, CURLIB
LMAPMBR	Symbolic map source member	Name, *MAP	Optional, Positional 5
REPLACE	Replace output objects	YES, NO	Optional, Positional 6
TGTRLS	Target release	Character value	Optional, Positional 7
TEXT	Text	Character value, SRCMBRTXT, BLANK	Optional, Positional 8

Top

Map object name (CICSMAP)

Specifies the qualified name of the generated 3270 or 5250 CICS BMS map.

The possible library values are:

*CURLIB: Specifies the library in which the output physical map will residue.
library-name: Specify the name of the library in which the physical map is located.

map-name: Specify the name of the generated map file.

Note: If a suffix operand is specified, the suffix is attached automatically to the name.

Map source file (SRCFILE)

Specifies the qualified name of the input BMS map source from which the 3270 or 5250 maps are created.

The possible library values are:

*LIBL: All libraries in the user and system portions of the job's library list are searched.
*CURLIB: The current library is searched. If no library is specified as the current library for the job, the QGPL library is used.
library-name: Specify the name of the library where the BMS map source file is located.

QMAPSRC: If a BMS map source file is not specified, the supplied source file QMAPSRC contains the map source.

source-map-name: Specify the name of the BMS map source from which the physical map file is created.

Map source member name (SRCMBR)

Specifies the name of the source file that contains the CICS map source.

*MAP: Specifies that the CICS map source is in the source file member that has the same member name as that specified in the CICSMAP parameter.
source-map-member-name: Specify the name of the source file member that contains the CICS map source.

Symbolic map source file (LMAPSRC)

Specifies the qualified name of the output source file which will contain the symbolic map as either a COBOL copybook or a C header file.

The possible library values are:

*LIBL: All libraries in the user and system portions of the job's library list are searched.
*CURLIB: The current library is searched. If no library is specified as the current library for the job, the QGPL library is used.
library-name: Specify the name of the library where the logical map will be generated.

The possible symbolic source file values are:

*DEFAULT: The source file name will default according to the value specified on the LANG parameter in the map source.
If LANG=COBOL then a source file name of QLBLSRC will be used.

If LANG=C then a source file name of H will be used.

If no LANG parameter is specified in the map source, then COBOL will be assumed and the source file name will be QLBLSRC.
source-file-name: Specify the name of the source file to which the language specific source statements should be copied.

Symbolic map source member (LMAPMBR)

Specifies the name of the source file member that contains the symbolic map source. If this parameter is not specified, the map name specified on the CICSMAP parameter is used.

Note: Care should be taken when using this parameter to make sure that you don't specify the same fully qualified name of a source member as that of an existing one; otherwise, you will replace the one that is already there.

*MAP: Specifies that the symbolic map's source member name is the same as the name specified in the CICSMAP parameter.
source-member-name: Specify the name of the source file member to which the symbolic map source statements should be copied.

Replace output objects (REPLACE)

Specifies whether a CICS BMS map is created when there is an existing CICS BMS map of the same name in the same library.

*YES: A CICS BMS map is created. If there is a CICS BMS map of the same name in the specified library, it is replaced.
*NO: A CICS BMS map is not created if a CICS BMS map of the same name already exists in the specified library.

Target release (TGTRLS)

Specifies the release level of the operating system on which you intend to use the object being created. In the examples given for the *CURRENT and *PRV values, and when specifying the target-release value, the format VxRxMx is used specify release, where Vx is the version, Rx is the release, and Mx is the modification level. For example, V3R6M0 is Version 3, Release 6, Modification 0.

Valid values for this parameter change every release.

The possible values are:

*CURRENT: The object is to be used on the release of the operating system currently running on your system. The object can also be used on a system with any subsequent release of the operating system installed.
*PRV: The object is to be used on the previous release with modification level 0 of the operating system. The object can also be used on a system with any subsequent release of the operating system installed.
release-level: Specify the release level in the format VxRxMx. The object can be used on a system with the specified release or with any subsequent release of the operating system installed.
Valid values depend on the current version, release, and modification level, and they change with each new release.

Text (TEXT)

Specifies the text that briefly describes the new CICS definition.

*SRCMBRTXT: The text is taken from the source file member being used to create the CICS map. Text for a database source member can be added or changed using the Source Entry Utility (STRSEU) command, or by using either the Add Physical File Member (ADDPFM) or Change Physical File Member (CHGPFM) command. If the source file is an inline file or a device file, the text is blank.
*BLANK: No text is specified.
description: Specify no more than 50 characters of text, enclosed by apostrophes.