*YES
: Specifies that a CICS module, program, or service program is to be created, and any existing object of the same name and type in the specified library is to be moved to QRPLOBJ. The *YES value is passed to either the
CRTCMOD or the CRTBNDC command.
*NO
: Specifies that a CICS module or program is not to be created if an object of the same name and type already exists in the specified library.
Examples
TEXT(’Statistical analysis program’)
This command runs the CICS translator, which translates the source in file ACTIVE in library ACCTS and then stores the changed source in the member STATS in file
QACYCICS in library QTEMP. If the source member contains any EXEC SQL statements, the member STATS in QACYCICS is used as input to the SQL translator. The changed source is stored in the member STATS in file QSQLTEMP in library QTEMP. If the SQL translator is needed, this member is used as input to the SQL compiler; otherwise, the member STATS in file QACYCICS is used as input to the ILE C compiler. The compiled program object, STATS, is placed in library ACCTS.
CRTCICSMAP
Job: B,I Pgm: B,I REXX: B,I Exec
*CURLIB/
CRTCICSMAP CICSMAP(
library-name/ map-name
)
SRCFILE(
*LIBL/
*CURLIB/
library-name/
QMAPSRC
source-map-name
)
(1)
*MAP
SRCMBR( )
source-map-member-name
LMAPSRC(
*LIBL/
*CURLIB/
library-name/
*DEFAULT
symbolic-map-srce-file
)
LMAPMBR(
*MAP
symbolic-map-srce-member
) REPLACE(
*YES
*NO
)
Chapter 30. OS/400 control language (CL) commands
301
TGTRLS(
*CURRENT
*PRV
release-level
) TEXT(
*SRCMBRTXT
*BLANK
'description'
)
Notes:
1 All parameters preceding this point can be specified positionally.
Function
The Create CICS MAP (CRTCICSMAP) command allows you to create BMS physical and symbolic maps.
Required parameters
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 reside.
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 in the input BMS macro source, 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.
302
CICS for iSeries Application Programming Guide V5
Symbolic map source (LMAPSRC)
specifies the qualified name of the output source file that 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 searched.
library-name
: Specify the name of the library where the symbolic map will be generated.
The possible symbolic source file values are:
*DEFAULT
: The source file name defaults according to the value specified on the LANG operand in the DFHMSD macro in the map source:
– If LANG=COBOL, a source file name of QLBLSRC will be used.
– If LANG=C, a source file name of H will be used.
– If no LANG operand is specified in the map source, COBOL will be assumed as the source file name will be QLBLSRC.
symbolic-map-srce-file
: Specify the name of the source file to which the language-specific source statements are to 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 in the
CICSMAP parameter is used.
Note:
You should take care when using this parameter that you do not specify the fully-qualified name of a source member that already exists. If you do, the existing source member will be replaced.
*MAP
: Specifies that the symbolic map source member name is the same as the name specified in the CICSMAP parameter of the PPT.
symbolic-map-srce-member
: Specify the name of the source file member to which the symbolic map source statements are to 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 CICS/400 system on which you intend to use the object being created.
You can specify an exact release level in the format VxRxMx, where Vx is the version, Rx is the release, and Mx is the modification level. For example,
V5R2M0 would be version 5, release 2, modification 0.
The possible values are:
Chapter 30. OS/400 control language (CL) commands
303
*CURRENT:
Specifies that the object is to be used on the release of CICS/400 currently running on your system. For example, if V5R2M0 is running on the system, *CURRENT means that you intend to use the object on a system with
V5R2M0 installed.
*PRV:
The object is to be used on the previous release of CICS/400. If V5R2M0 is running on your system, *PRV means that you intend to use the object on a system with V5R1M0 installed.
release-level:
Specify the release level in the format VxRxMx. The object can be used on a system with the specified release.
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 the 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.
Examples
CRTCICSMAP CICSMAP(MYLIB/MYMAP) +
SRCMBR(*MAP) LMAPSRC(MYLIB/QLBLSRC) +
LMAPMBR(*MAP) TEXT(’My test BMS map.’)
This command generates a 3270 or 5250 CICS BMS physical map in library MYLIB with name MYMAP, and a symbolic map in member MYMAP, in file QLBLSRC, on library MYLIB.
304
CICS for iSeries Application Programming Guide V5
