sdf ii tool 2
DESCRIPTION
How to create CICS maps in MainframeTRANSCRIPT
WORKING ON SDF II TOOLUNDERSTANDING SDF II TOOL
LEARN VISUALLY WITH EXAMPLES
THIS DOCUMENT PROVIDES A BRIEF DESCRIPTION ON HOW
SDF II TOOL CAN BE USED TO CREATE CICS MAPS.
DOCUMENT PREPARED BY:
JAVEED AHMED - [email protected]
---------------------------------------------------------------------------------------------------
CREATE 3 PDS USING FOLLOWING OPTIONS FROM ISPF PANEL– OPTION 3.2
OPTION 3 - UTILITIES (PERFORM UTILITY FUNCTIONS)
OPTION 2 - DATA SET (ALLOCATE, RENAME, DELETE, CATALOG..)
EXAMPLE
->USERID.TEST.CICS.BMSMACRO
THIS CONTAINS THE GENERATED MACRO OF THE PANEL (CICS MAP).
->USERID.TEST.CICS.BMSOUT
THIS CONTAINS THE GENERATED SYMBOLIC MAP OF THE PANEL (CICS MAP).
->USERID.TEST.CICS.DGIPNL
THIS CONTAINS THE LOAD MODULE OF THE PANEL (CICS MAP).
STEP1: USE OPTION 9.6.1 FROM ISPF PANEL TO ENTER INTO SDF II TOOL:
OPTION 9 - IBM PRODUCTS (IBM PROGRAM DEVELOPMENT PRODUCTS)
OPTION 6 - SDF II (SCREEN DEFINITION FACILITY II-EDITORS AND
UTILITIES)
OPTION 1 –SDF II FUNCTIONS (RUN EDITOR AND UTILITIES)
CLICK ON THE FUNCTIONS TO TRAVERSE THROUGH THE SCREENS.
SELECT THE FUNCTIONS IN FOLLOWING STEPS:
SPECIFY LIBRARIES-->PANEL EDITOR-->GENERATE
SELECT AN SDF II FUNCTION
1 PANEL EDITOR Create or edit a panel 2 PANEL GROUP EDITOR Create or edit a panel group
3 PARTITION SET EDITOR Create or edit a partition set 4 AID TABLE EDITOR Create or edit an AID table 5 CONTROL TABLE EDITOR Create or edit a control table
6 GENERATE Generate control block source and data structure
7 LIST OBJECTS List objects in the library
8 SPECIFY LIBRARIES Access libraries
9 UTILITIES Print, Import, Convert, Construct, Extract, and Modify Objects 10 PROFILE Modify editing defaults
11 SDF II PROTOTYPE Define and run a prototype
12 PRINT REFERENCE Print the online reference
R REFERENCE Obtain SDF II online reference
X EXIT Terminate SDF II dialog
SPECIFY LIBRARY SELECT OPTION 8 FROM SDF II FUNCTION (SPECIFY LIBRARY):
NOTE: YOU HAVE CREATED PDS IN FORM- USERID.XXXX.XXXX.XXXXX .
THIS PDS WILL BE USED AS LIBRARIES IN SDF II. BUT WHILE SPECIFYING IN
LIBRARY , IT SHOULD BE ENTERED AS 'USERID.XXXX.XXXX'.
REFER SCREEN- SCREEN (1SL).
PRESS ENTER (TO SAVE) AND THEN PRESS F3 (TO GO BACK).
SCREEN (1SL)
BACK TO SDF II FUNCTION
STEP2: SELECT OPTION 1 FROM SDF II FUNCTION (PANEL EDITOR):
FOLLOWING DETAILS TO BE ENTERED
PANEL NAME - BLRMS15 (IN LIBRARY UBET337.TEST.CICS.BMSMACRO)
LIBRARY - 1 (LIBRARY ID NAME)
DEVICE TYPE - 3270
SELECT OPTION 2 TO CREATE A NEW PANEL FROM SCRATCH FOR CICS/BMS.
REFER SCREEN- SCREEN (1PE).
SCREEN (1PE)
PRESS ENTER TO GO TO NEXT SCREEN (PANEL EDITOR DIALOG SCREEN).
REFER SCREEN- SCREEN (2PE).
SCREEN (2PE)
USE THE BELOW SCREEN TO TRAVERSE THROUGH THE OPTIONS AVAILABLE IN
PANEL EDITOR DIALOG.
PANEL EDITOR CLICK ON THE REQUIRED LINKS PROVIDED IN THE BELOW SCREEN TO
TRAVERSE THROUGH THE SCREENS.
SELECT A PANEL EDITOR DIALOG
1 CHARACTERISTICS Define panel characteristics
2 FORMAT Define the format of the panel
3 FIELDS Define the fields for the format
4 ATTRIBUTES Define the attributes for the format
5 STRUCTURE Define the data structure of the panel
6 SYSTEM Define target system dependent information
7 TEST Show panel in execution time format
8 INSTANCES Define the panel instances
* FIELD EDITING Define field editing and verification rules
BACK TO SDF II FUNCTION
CHARACTERISTICS
STEP3: SELECT OPTION 1 FROM PANEL EDITOR SCREEN (CHARACTERISTICS):
FOLLOWING DETAILS TO BE ENTERED
DESCRIPTION – PANEL 1 (ANY DESCRIPTION ABOUT THE PANEL)
FIELD NAME PREFIX – IS USED AS THE FIRST PART OF ALL FIELD NAMES
IN THE DATA STRUCTURE
REFER SCREEN– SCREEN (1CH).
SCREEN (1CH)
PRESS F8 TO SCROLL DOWN.
FOLLOWING DETAILS TO BE ENTERED
DYNAMIC FIELD ATTRIBUTE MODIFICATION – YOU DEFINE THE
ATTRIBUTES THAT CAN DYNAMICALLY BE MODIFIED BY THE
APPLICATION PROGRAM.
REFER SCREEN- SCREEN (2CH).
SCREEN (2CH)
BACK TO PANEL EDITOR
FORMAT STEP4: SELECT OPTION 2 FROM PANEL EDITOR SCREEN (FORMAT):
IN THIS SCREEN, DESIGNING OF THE CICS SCREEN WILL BE DONE.
THE HEADER, TRAILER, CONSTANT FIELD NAMES AND MESSAGES NEED TO BE
ENTERED, ACCORDING TO THE PANEL(CICS MAP) SPECIFICATIONS.
REFER SCREEN- SCREEN (1FO).
SCREEN (1FO)
BACK TO PANEL EDITOR
FIELDS STEP5: SELECT OPTION 3 FROM PANEL EDITOR SCREEN (FIELDS):
ENTER THE FIELD NAME, LINE NUMBER, COLUMN NUMBER, WIDTH – NO OF
BYTES, DEPTH-IF APPLICABLE , BY HAVING A LOOK AT THE FORMAT PORTION.
REFER SCREEN- SCREEN (1FE).
SCREEN (1FE)
BACK TO PANEL EDITOR
ATTRIBUTES STEP6: SELECT OPTION 4 FROM PANEL EDITOR DIALOG (ATTRIBUTE):
DEFINE ATTRIBUTE SCREEN, IS DIVIDED INTO 2 PARTS.
1. ATTRIBUTE DESCRIPTORS
2. FORMAT FIELDS
ATTRIBUTE DESCRIPTORS:
HERE WE CAN SET ATTRIBUTES FOR EACH FIELD.
TO SET ATTRIBUTES USE THE FOLLOWING RULES.
1. ENTER SOME DESCRIPTION IN DESC FIELD(THIS CAN CONTAIN ONLY
SINGLE SPECIAL CHARACTERS, NUMBER AND ALPHABETS).
2. ENTER THE ATTRIBUTES WHICH YOU WANT TO SET FOR THE DESCRIPTOR
AND RESS ENTER.
REFER SCREEN- SCREEN (1AT).
SCREEN (1AT)
SCREEN (1AT) OF ATTRIBUTE DESCRIPTORS SHOWS, HOW (!) AND (@)
SYMBOLS ARE USED AS DESCRIPTORS TO ASSIGN ATTRIBUTES.
IN THE ABOVE SCREEN, THE FORMAT FIELD SECTION HAS BEEN EDITED FOR
BETTER UNDERSTANDING PURPOSE.
FORMAT FIELDS:
HERE WE HAVE TO ENTER THE DESCRIPTOR SYMBOL (THAT YOU HAVE DEFINED
IN THE ATTRIBUTE DESCRIPTORS) IN THE SECOND LINE OF THE FIELD AND
PRESS ENTER.
EXAMPLE:
005 ADDRESS : ____________________________
!_____________________________
006 PHONE NUMBER : ____________________________
@___________________________
THE ABOVE REPRESENTATION SHOWS THAT THE DESCRIPTOR VALUE (!) WITH
ATTRIBUTES(UNP NOR TU SK) WILL BE ASSIGNED TO THE FIELD NAME
‘ADDRESS’.
SIMILARLY THE DESCRIPTOR VALUE (@) WITH ATTRIBUTES ( UNP NOR TU )
WILL BE ASSIGNED TO FIELD NAME ‘ PHONE NUMBER’.
REFER SCREEN- SCREEN (2AT).
SCREEN (2AT)
SCREEN (2AT) OF FORMAT FIELD ,SHOWS HOW DESCRIPTOR SYMBOLS
((!) AND (@)) ARE USED TO ASSIGN ATTRIBUTES.
IMPORTANT NOTE: IF YOU HAVE ANY DOUBT IN ASSIGNING ANY ATTRIBUTES
VALUES TO THE FIELD. ENTER ? IN THE ATTRIBUTE FIELD AND PRESS ENTER.
YOU WILL BE ABLE TO GET ALL POSSIBLE VALUES THAT YOU CAN ASSIGN.
REFER SCREEN- SCREEN (3AT).
SCREEN (3AT)
BACK TO PANEL EDITOR
STRUCTURESTEP7: SELECT OPTION 5 FROM PANEL EDITOR SCREEN (STRUCTURE):
NOTE: THIS DIALOG CAN BE USED TO DEFINE AND EDIT THE DATA STRUCTURE
THAT WILL BE USED BY THE APPLICATION PROGRAM. THE STRUCTURE IS
INDEPENDENT OF THE PROGRAMMING LANGUAGE USED IN THE APPLICATION
PROGRAM. SDF II USES THIS STRUCTURE WHEN IT GENERATES THE DATA
STRUCTURE FOR A PARTICULAR LANGUAGE. VARIABLE FIELDS CAN BE
DIVIDED INTO SUBFIELDS.
REFER SCREEN - SCREEN (1ST).
SCREEN(1ST)
NOW YOU DEFINE SUBFIELDS FOR THE DOB, DATE(DD), MONTH(MM) AND
YEAR(YY) . THAT MAKE UP THE DOB FIELD OF THE TEST PANEL TO ENABLE THE
APPLICATION USING THE TEST PANEL TO TRANSMIT DATA TO OR RECEIVE
DATA FROM EACH SUBFIELD SEPARATELY. FIRST ENTER THE I LINE COMMAND
TO INSERT BLANK LINE, THEN ENTER THE NAME , LENGTH.
REFER SCREEN - SCREEN (2ST).
SCREEN (2ST)
BACK TO PANEL EDITOR
SYSTEM STEP8: SELECT OPTION 6 FROM PANEL EDITOR SCREEN (SYSTEM):
SELECT THE ATTRIBUTES BY USING ‘/’.
REFER SCREEN - SCREEN (1SY).
SCREEN (1SY)
BACK TO PANEL EDITOR
TEST STEP9: SELECT OPTION 7 FROM PANEL EDITOR DIALOG (TEST):
THE SCREEN BELOW - SCREEN (1TE) IS USED FOR TESTING THE DESIGNED
SCREEN.
SCREEN (1TE)
TO CHECK FOR THE ASSIGNED ATTRIBUTE TYPE, TYPE IN SOME DATA IN THE
CORRESPONDING FIELDS.
REFER SCREEN - SCREEN (2TE) AND SCREEN (3TE) .
SCREEN (2TE)
REFER SCREEN – SCREEN (3TE).
SCREEN (3TE) SHOWS HOW DIFFERENT ATTRIBUTES CAN BE SET FOR
DIFFERENT FIELDS. COMPARE SCREENS SCREEN (3TE) AND SCREEN (2TE).
SCREEN (3TE)
END OF PANEL EDITOR FUNCTIONS. CLICK ON THE BELOW LINK TO GO BACK
TO PANEL EDITOR SCREEN . GO TO SDF II FUNCTION SCREEN TO MAKE USE OF
GENERATE OPTION.
BACK TO PANEL EDITOR
GENERATESTEP10: TO COMPILE THE PANEL (CICS MAP) SELECT OPTION 6 FROM SDF II
FUNCTION SCREEN(GENERATE):
REFER SCREEN - SCREEN (1GE) .
SCREEN (1GE)
FOLLOWING DETAILS TO BE ENTERED
NAME: PANEL NAME-BLRMS15 ( CHECK STEP2 )
LIBRARY: 1 (LIBRARY ID)
TYPE: P ( TYPE OF PANEL GENERATED)
TARGET SYSTEM: 1 ( CICS/BMS)
REFER SCREEN - SCREEN (2GE) .
SCREEN (2GE)
PRESS ENTER TO GO TO NEXT SCREEN(SPECIFY GENERATION PARAMETERS).
REFER SCREEN - SCREEN (3GE) .
FOLLOWING DETAILS TO BE ENTERED
LANGUAGE: COBOL, ASM, C, PLI
REFER SCREEN – SCREEN (3GE) .
SCREEN (3GE)
PRESS F8 TO SCROLL DOWN.
REFER SCREEN - SCREEN (4GE) .
FOLLOWING DETAILS TO BE ENTERED:
OUTPUT LIBRARY FOR DATA STRUCTURE -
DATASET NAME - ENTER THE DATASET NAME OF THE SYMBOLIC MAP.
OUTPUT LIBRARY FOR BMS MACRO -
DATASET NAME - ENTER THE DATASET NAME OF THE MACRO.
REFER SCREEN - SCREEN (4GE).
SCREEN (4GE)
PRESS ENTER TO GO TO NEXT SCREEN (LIST GENERATION MESSAGES SCREEN).
REFER SCREEN - SCREEN (5GE) .
SCREEN (5GE)
TO CHECK FOR THE GENERATED MACRO CHECK IN PDS
(UBET337.TEST.CICS.BMSMACRO).
TO CHECK FOR THE GENERATED SYMBOLIC MAP CHECK IN PDS
(UBET337.TEST.CICS.BMSOUT).
BACK
HOW TO DEFINE ATTRIBUTES TO FIELDSMETHOD 2: MAKING USE OF MARKS
ALL STEPS ARE THE SAME AS DISCUSSED IN THE ABOVE SCREENS.
IF YOU MAKE USE OF MARKS METHOD, THEN DONT USE THE OPTION 4 FROM
FROM PANEL EDITOR DIALOG (ATTRIBUTE).
IN STEP4 (FORMAT) WE CAN MAKE USE OF MARKS TO SET ATTRIBUTES TO THE
FIELDS.
USE THE FOLLOWING STEPS TO DEFINE ATTRIBUTES WITH HELP OF
MARKS.
STEP1: MAKE USE OF OPTION 2 (FORMAT) TO DEFINE THE FORMAT OF THE
SCREEN.
STEP2: NOW ENTER MARKS ON THE COMMAND LINE (AFTER ENTERING INTO
FORMAT REGION) AND PRESS ENTER.
REFER SCREEN - SCREEN (1ME).
SCREEN (1ME)
STEP3: AFTER ENTERING THE DEFINE MARKS SCREEN, YOU CAN FIND A LIST
OF DEFAULT ATTRIBUTES.
REFER SCREEN - SCREEN (2ME) .
SCREEN (2ME)
HERE YOU CAN ASSIGN YOUR OWN ATTRIBUTES.
BACKGRND CAN BE USED TO SET ATTRIBUTES FOR THE BACKGROUND SCREENS
EG. TITTLE, FIELD NAMES..ETC.
VARIABLE CAN BE USED TO SET ATTRIBUTES FOR THE VARIABLE INPUTS.
EG. FIELDS THAT ARE TO BE ENTERED IN THE MAP.
2 BACKGRND TYPE CANNOT BE USED.
FOR MORE INFORMATION MAKE USE OF THE ONLINE REFERENCE IN HELP.
REFER SCREENS- SCREEN (3ME/1/2/3) WHICH SHOWS HOW WE CAN SET NEW
VARIABLE TYPE ATTRIBUTE.
SCREEN (3ME/1)
REFER SCREEN - SCREEN (3ME/2).
SCREEN (3ME/2)
REFER SCREEN - SCREEN (3ME/3) .
SCREEN (3ME/3)
IN THE ABOVE SCREEN - SCREEN (3ME/3) WE HAVE CREATED A NEW
MARK (MAR)- %, AND HAVE ASSIGNED ATTRIBUTES (UNP NOR NUM PI).
PRESS ENTER (TO SAVE) AND F3 (TO GO BACK).
STEP4: AFTER ASSIGNING THE MARKS. SELECT OPTION 3 FROM PANEL EDITOR
DIALOG (FIELDS):
REFER SCREEN – SCREEN (4ME) .
SCREEN (4ME)
WHILE DEFINING THE FIELDS, YOU HAVE TO ENTER THE MARK TYPE THAT YOU
HAVE DEFINED IN STEP4, IN MARFIELD.
MARKS USED HERE ARE _ AND % .
REFER THE ABOVE SCREEN – SCREEN (4ME).
SO YOU CAN SET THE ATTRIBUTES BEFORE, USING THE MARK METHOD , IN THE
DEFINE MARKS SCREEN AND USE THE MARK SYMBOL IN THE MAR FIELD OF
THE DEFINE FIELD TO SET THE ATTRIBUTES.
NOW JUST HAVE A LOOK AT THE DEFINE FORMAT SCREEN AFTER FINISHING
WITH THE DEFINE FIELD SECTION.
REFER SCREEN – SCREEN (5ME) .
SCREEN (5ME)
HERE YOU CAN SEE THE MAR SYMBOL THAT YOU HAVE ASSIGNED TO THE
FIELDS.
EG. PHONE NUMBER-MAR TYPE USED IS '%'.
ADDRESS – MAR TYPE IS '_'.
SCREEN– SCREEN (6ME) SHOWS THE OUTPUT OF THE PANEL.