zCICS Basic Mapping Support

zCICS Basic Mapping Support
v11
Automated Software Tools Corporation.
Copyright 2009 Automated Software Tools Corporation. This is part of z390 distributed under open source !" "icense.
zCICS Basic Mapping Support Table of Contents

Introduction BMS Macros DFHMSD DFHMDI DFHMDF Map generation Change Summary Trademar s Credits

Introduction This document outlines the extensions and facilities implemented in zCICS. Please refer to the IBM Manuals on BMS usage. The documentation for E EC CICS SE!" MAP# $ECEI%E MAP and SE!" C&!T$&' are in the zCICS Application Programming (uide. The following BMS facilities are not )et implemented* Support for de+ices outside the ,-./ famil) Printers Extended Attri0utes 1other than colour2 and alternate screen size ")namic Map Positioning and ACC3M processing Partitioning Paging

BMS Macros 1! DFHMSD "" Mapset definition and termination
Although "45MS" is optional it is recommended that one is coded. A default set of +alues will 0e internall) generated from the "45M"I macro if missing.
!ame mapset &peration DFHMSD &perands TYPE=MAP/DSECT/FINAL MODE=IN/OUT/INOUT LANG=ASM/COBOL CTRL= CURSLOC=YES/NO DSATTS= EXTATT=YES/NO/MAPONLY MAPATTS= STORAGE=AUTO TIOAPFX=YES/NO TERM=
!otes* TE$M6 is supported 0ut discarded Errors* A MA IM3M &4 , &PE$A!"S A''&7E" I! CT$' CA!!&T 5A%E M&$E T5A! &!E "45MS" MAC$& "SATTS IS SPECI4IE" 7IT5&3T MAPATTS E TATT C&!4'ICTS 7IT5 "SATTS8MAPATTS E TATT !&T !&# MAP&!'9 &$ 9ES I!%A'I" C3$S'&C :: cursloc I!%A'I" 'A!( :: lang I!%A'I" M&"E :: mode I!%A'I" ST&$A(E :: storage I!%A'I" TI&AP4 :: tioapfx I!%A'I" T9PE :: t)pe MAPSET !AME IS MISSI!( P&SITI&!A' &PE$A!" xxxx I!%A'I"

#! DFHMDI "" Map definition
&peration DFHMDI &perands TYPE=MAP/DSECT MODE=IN/OUT/INOUT LANG=ASM/COBOL CTRL= CURSLOC=YES/NO DSATTS= EXTATT= MAPATTS= SIZE= !"#$%& LINE=' COLUMN=' STORAGE=AUTO TIOAPFX=YES/NO (USTIFY= NOLABEL=
!ame mapname
!otes* T9PE and ST&$A(E are re;uired here onl) if the "45MS" macro is omitted. Parameters T9PE# M&"E# 'A!(# CT$'# C3$S'&C# "SATTS# E TATT# MAPATTS# ST&$A(E and TI&AP4 can all 0e omitted if the settings specified in "45MS" are correct for this map. M&"E ma) 0e specified as an o+erride to "45MS". This facilit) is an extension. An) option1s2 specified in CT$' will o+erride all the options specified in "45MS". 4or 'I!E and C&'3M!# onl) numeric parameters are supported. <3STI49 is discarded. !&'ABE' is a special parameter for zCICS maps. It suppresses the la0el indicated and speeds up the map assem0l). 7hen used on the "45M"I macro it applies to all la0elled "45M"4 macros that follow. 7hen specified on the "45M"4 macro it o+errides an) specification on the "45M"I macro. The la0els that can 0e suppressed are as follows* A 1attri0ute2# C 1colour2# 4 1flag2# ' 1length2# & 1output2 eg. !&'ABE'6AC4

Errors* A MA IM3M &4 , &PE$A!"S A''&7E" I! CT$' C&'3M! CA!!&T E CEE" nn "SATTS is specified without MAPATTS E TATT conflicts with MAPATTS8"SATTS E TATT not omitted# !&# MAP&!'9 or 9ES I!%A'I" CT$' &PTI&! : ctrl I!%A'I" C3$S'&C :: cursloc I!%A'I" M&"E :: mode I!%A'I" SI=E :: size I!%A'I" TI&AP4 :: tioapfx 'I!E CA!!&T E CEE" nn MAP!AME IS MISSI!( MS" A!" M"I T9PE MISMATC5 P&SITI&!A' &PE$A!" xxxx I!%A'I"

$! DFHMDF "" Field definition
&peration DFHMDF &perands POS=n/ n#n& LENGTH= ATTRB= COLOR= (USTIFY= INITIAL= XINIT= PICIN= PICOUT= OCCURS= GRPNAME= NOLABEL=
!ame )*+name
!otes* fldname ma) now use long names P&S does not ha+e to 0e in se;uence. If ATT$B is missing then ATT$B61AS>IP#!&$M2 is assumed. If protection or intensit) parameters are missing then a sensi0le default is assumed. A field specified as ATT$B613!P$&T#!3M2 will onl) accept digits /:?. Some ,-./ models also allowed dots and commas. Extensi+e cross:chec@ing is made# such that an) AunusualA map structure is flagged as an error. A peruse of the errors 0elow gi+e a good indication of these t)pes of map structure. Extensions* ATT$B61A'P5A2 has 0een added as the opposite of !3M I!IT644.. The dots are replaced 0) a hex code of a fill character. This will generate an $A order to fill this field for its whole length. e.g. Instead of coding I!ITIA'6ABBBBBBBBBBA Code I!IT644C" PICI! and PIC&3T 1(eneral2 These parameters are not well:descri0ed in the IBM Manuals.

PICI! 1C&B&'2 A s)m0olic reference to the input data# the data cannot 0e changed. ie. PICI!6ADDD?A does not ma@e an) sense PICI!6A??%??A tells C&B&' where the decimal point is PIC&3T 1C&B&'2 The data is su0Eect to an editting process. ie. PIC&3T6ADDD?A the data is editted PIC&3T6A??%??A is the same as A?1F2A PICI! 1Assem0ler2...extension The incoming data IS su0Eected to an editting process. "escri0ed 0elow. PIC&3T 1Assem0ler2...extension The outgoing data is su0Eected to an editting process. "escri0ed 0elow. PICI! and PIC&3T 1Assem0ler2 The parameter is 1almost2 a standard edit word with some restraints. Currentl) onl) numeric data can 0e su0Eected to PICI!8PIC&3T. PIC&3T... &perates for a SE!" MAP# 0ut not if MAP&!'9 is specified. "ata is ta@en from the map structure and su0Eected to the edit word 0efore 0eing sent to the screen. PICI!... &perates for a $ECEI%E MAP. The data recei+ed is su0Eected to the edit word and then passed to the application in the map structure. !ote that the resulting data ma) no longer 0e numeric. The edit word has some strict rules at present. Suggested extensions are most welcome. The first hex pair must 0e F/ 10lan@2# GC 1asteris@2# GB 1dollar2 or F" 1open 0rac@et2. Blan@ and asteris@ are fill characters# dollar and open 0rac@et are float characters. The remaining hex pairs can 0e -/ 1digit select2# -H 1significance

starter2# FB 1dot2 or CB 1comma2. The num0er of -/ and -HAs must 0e odd. Examples... PIC&3T6F/-/-HCB-/-/-/ "ata is H-,FG# displa)ed as H-#,FG PIC&3T6GB-/-HCB-/-/-/ "ata is H-,F # displa)ed as DH#-,F PIC&3T6GC-/-HCB-/-/-/ "ata is I?# displa)ed as JJJJJI? PICI! is no different# Eust that it edits incoming data. If the data to 0e processed is not numeric after 0eing PAC>ed# a MAP4AI'8I condition is raised. IM( file 4or each T9PE6MAP generation# a mapname.IM( file is generated. This gi+es a s)m0olic picture of the resulting screen and can 0e used for planning map changes. See the file (3IC.IM( for a good example. !&'ABE' !&'ABE' is a special parameter for zCICS maps. It suppresses the la0el indicated and speeds up the map assem0l). 7hen used on the "45M"I macro it applies to all la0elled "45M"4 macros that follow. 7hen specified on the "45M"4 macro it o+errides an) specification on the "45M"I macro. The la0els that can 0e suppressed are as follows* A 1attri0ute2# C 1colour2# 4 1flag2# ' 1length2# & 1output2 eg. !&'ABE'6AC4 Errors* A MA IM3M &4 - &PE$A!"S A''&7E" I! <3STI49 A"<ACE!T ATT$IB3TE AT P&S nnn ATT$IB3TE C&!4'ICT : A'P5A A!" !3M ATT$IB3TE C&!4'ICT : AS>IP A!" A'P5A ATT$IB3TE C&!4'ICT : AS>IP A!" !3M ATT$IB3TE C&!4'ICT : AS>IP A!" P$&T

ATT$IB3TE C&!4'ICT : AS>IP A!" 3!P$&T ATT$IB3TE C&!4'ICT : B$T A!" "$> ATT$IB3TE C&!4'ICT : B$T A!" !&$M ATT$IB3TE C&!4'ICT : !&$M A!" "$> ATT$IB3TE C&!4'ICT : P$&T A!" 3!P$&T BA" 'E!(T5 : length B&T5 I!ITIA' A!" I!IT A$E SPECI4IE" C&!4'ICTI!( <3STI49 PA$MS ($P!AME A!" &CC3$S A$E SPECI4IE" ($P!AME SPECI4IE" 7IT5&3T 4'"!AME IC ATT$IB3TE 5AS &CC3$$E" I! A!&T5E$ M"4 MAC$& I!ITIA'8 I!IT IS ($EATE$ T5A! 'E!(T5 I!ITIA'8 I!IT IS I!%A'I" 7IT5 'E!(T56/ I!%A'I" ATT$B &PTI&! K attr0 I!%A'I" C&'&$ I!%A'I" <3STI49 &PTI&! : Eustif) I!%A'I" &CC3$S : occurs I!%A'I" P&S : pos <3STI49 C&!4'ICT : B'A!> A!" =E$& <3STI49 C&!4'ICT : 'E4T A!" $I(5T 'E!(T56/ IS I!%A'I" 4&$ !AME" 4IE'" PICI!8PIC&3T CA! &!'9 BE SPECI4IE" 4&$ A !AME" 4IE'" PICI!8PIC&3T 5AS &"" !3MBE$ &4 5E "I(ITS PICI!8PIC&3T 5E 'E!(T5 !&T EL3A' T& 'E!(T5 PICI!8PIC&3T IS I!%A'I" PICI!8PIC&3T* HST PAI$ !&T F/# GC# GB# F" PICI!8PIC&3T* !3MBE$ &4 -/8-H IS !&T &"" P&S nnn &%E$'APS 7IT5 A!&T5E$ 4IE'" P&S C&'3M!M'E!(T5 E CEE"S "E4I!E" MAP SI=E P&S E CEE"S "E4I!E" MAP SI=E P&S 5AS T&& MA!9 PA$AMETE$S P&SITI&!A' &PE$A!" xxxx I!%A'I" SI!('E P&S E CEE"S "E4I!E" MAP SI=E SPECIA' 4&$MAT I!IT CA!!&T BE SPECI4IE" I4 'E!(T5 IS 'ESS T5A! I 3!!AME" 4IE'" 5AS 3!P$&T &$ 4SET# I!P3T "ATA CA!!&T BE MAPPE" I!IT 5AS &"" !3MBE$ &4 5E "I(ITS The following errors occur owing to internal limits. Please report them. A! I!TE$!A' E$$&$ 5AS &CC3$$E" E$$&$ I! ATT$IB3TE TAB'E nnnn A! I!TE$!A' E$$&$ 5AS &CC3$$E"
10

MAPSI=E T&& 'A$(E : nnnn A! I!TE$!A' E$$&$ 5AS &CC3$$E" PICI!8PIC&3T 'E!(T5 ($EATE$ T5A! G/ B9TES
11

Map generation See the sample generation for MAP/H em0edded in "45A''.BAT. This generates the T9PE6"SECT 1MAP/H.CP92 and the T9PE6MAP 1MAP/H.,?/2. 4or 'A!(6C&B&'# the structure will ha+e a .CP= suffix. This suffix is the default for the zC&B&' C&P9 statement. As the program name is the same# the T9PE6"SECT assem0ler output is renamed mapset.P$H. Change Summary 4e0ruar) H# -/HComment on long fldname support added !o+em0er H# -/H/ Colour support# E TATT# "SATTS# MAPATTS and C&'&$ parameters added and extra M!&TEs. "45M"I and "45M"4 new !&'ABE' parameter August H# -//? 3pdate to PICI! and PIC&3T doc. 4e0ruar) -H# -//? Added 'A!(6C&B&' and mention of the .CP= suffix Added commentar) separating PICI!8PIC&3T 0) language !o+em0er -F# -//I Added comment a0out P&S TI&AP4 is full) supported TE$M is supported 0ut discarded Extra error chec@ing for 'I!E8C&'3M! Trademar s IBM# CICS and %SAM are registered trademar@s of International Business Machines Corporation.
12

Credits Author * Mel+)n Maltz 4ormatter * 7alter Petras Shipping "ate* 4e0ruar) H# -/H=,?/ +ersion * %H.G./G zCICS +ersion* %HH
13

zCICS Basic Mapping Support - PDFRHZ

Încărcat de

Informații document

Descriere originală:

Titlu original

Drepturi de autor

Formate disponibile

Partajați acest document

Partajați sau inserați document

Opțiuni de partajare

Vi se pare util acest document?

Este necorespunzător acest conținut?

Drepturi de autor:

Formate disponibile

zCICS Basic Mapping Support - PDFRHZ

Încărcat de

Drepturi de autor:

Formate disponibile

Automated Software Tools Corporation.