Contest number : 62927

Generate a display panel using REXX

Component Development Specification

1. Design main topics

This project is to create an REXX panel to fetch records from DB and display those to the user. 1. Design Patterns N/A 2. Industry Standards N/A

3. Required Algorithms : The following logic should be followed in this program.

The panel design is attached in the File layout section 2.2

1. On executing the REXX program the display panel should be thrown. The design of the display panel is given in display_screen.xls. 2. The current logged in user details are checked in the LJATOWNR table. 3. Select ACCESS_LVL from the table LJATOWNR where USER_ID = Logged in user id and REC_TYPE = 'A'. 4. When ACCESS_LVL = 'D' perform the below 1. Fetch the records from the table LJATEREQ with OWNER_APVL as Y 2. Display them in the panel ( display_screen.xls) 3. Display only 12 records in a screen. 4. When the user presses PF8 the next 12 records should be displayed. 5. In the last screen F8 => Forward should not be displayed. Similarly in the first screen F7 backward should not be displayed.

6. If there are less than 12 records to be displayed then both F8 => Forward and F7 backward should not be displayed. 7. When the user enters S in the SEL line a new panel is displayed 1. The template for the panel is Detail_screen.xls present in this Zip. 2. The values to be populated in the panel is given in the below table. 3. REQ NO,JOB TYPE,JOB_NAME,INSTALLED and APPL_REG are fetched from LJATEREQ and displayed in the panel. 4. The above fields should be protected. 5. TSRM NO,INSTALL DATE AND USER ID should be entered by the user. 6. The values should be updated in the table (LJATEREQ )in the corresponding columns. 7. Throw an error message when either one of the three field is blank. 8. Error message in the message line (Line 24) should be Please enter the FIELD NAME where FIELD NAME is the name of the field which is blank. Highlight the filed in RED colour and place the cursor in the position. 9. Once the values are entered in the table display the first screen with the message Successful insertion in the message line of first panel. Name in Panel REQ NO JOB TYPE JOB NAME INSTALLED TSRM NO INSTALL DATE USER ID APPL REG Column name in table REQ_NUM JOB_IND JOB_NAME IS_INSTALLED TSRM_NO PLAN_INSTALL_DATE INSTALLATION_USER_ID APPL_REGION

8. The null values and default values should be handled while inserting into the table. 9. UPDATE_DATE should be current timestamp. 10. UPDATE_ID should be the current user id (Logon id). 11. When the user press enter after filling the panel an E-Mail should be triggered to the user id with the following details 1. Subject should be A new TSRM change request is created

2. The contents of the Email should be Please create the installation package for the below details Request Number : REQ_NUM Planned Install Date : PLAN_ INSTALL_DATE Application Region: APPL_REGION Request created by : CREATED_ID TSRM No: TSRM_NO

5. When ACCESS_LVL = 'A' perform the below 1. Fetch the records from the table LJATEREQ with OWNER_APVL as N or spaces. 2. When the user enters A in the SEL LINE then display screen should be protected. 3. Display a confirmation message as Press PF5 for confirmation or PF12 to cancel 4. When user enters PF5 then update the below columns in the table LJATEREQ 5. OWNER_APVL should be updated as 'Y' 6. UPDATE_DATE and APPROVAL_DATEshould be current timestamp. 7. UPDATE_ID and APPROVAL_ID should be the current user id (Logon id). 8. The null values and default values should be handled while inserting into the table. 6. End of Program. Testing procedure : Check whether a record is updated in LJATEREQ table when the user presses Enter in the option panel. Check whether the correct records are displayed depending on the ACCESS_LVL of LJATOWNR Check whether the validations are done properly for each filed before inserting into or updating the table. 4. Component Class Overview N/A 5. Component Exception Definitions N/A 6. Thread Safety N/A 7. Required deliverables - Program source code. - Unit Test case and Unit test results.

Note: Please use Environment configuration for development and testing as mentioned in Environment Requirements section below.

Please compress your deliverables as per the following directory structure:

/source : Program source /test : Unit test case and Unit test result

2. Environment Requirements
1. Environment

- MVS

Compiler Version
o IBM(R) Enterprise PL/I for z/OS o Version 3 Release 9 Modification 0

Link editor version

o Version 1 Release 11

The REXX program should be compatible in the above environment 1. Technologies

REXX panel for online panel creation. REXX or JCL for updating to the table and sending email. Whichever the participant feels as an optimized method.

3. File Layouts: LJATEREQ: Create a table with the below mentioned columns.

REQ_NUM CHAR(08) NOT NULL WITH DEFAULT, JOB_NAME CHAR(08) NOT NULL WITH DEFAULT, OWNER_APVL CHAR(01) NOT NULL WITH DEFAULT, JOB_IND CHAR(01) NOT NULL WITH DEFAULT, APPL_REGION CHAR(03) NOT NULL WITH DEFAULT, OWNER_ID CHAR(07) NOT NULL , INSTALLATION_USER_ID CHAR(07) , TSRM_NO CHAR(07) , IS_INSTALLED CHAR(01) , PLAN_INSTALL_DATE DATE NOT NULL , INSTALL_DATE DATE NOT NULL , UPDATE_DATE TIMESTAMP NOT NULL , UPDATE_ID CHAR(07) NOT NULL , CREATED_DATE TIMESTAMP NOT NULL , CREATED_ID CHAR(07) NOT NULL , APPROVAL_DATE TIMESTAMP NOT NULL , APPROVAL_ID CHAR(07)

LJATOWNR

USER_ID CHAR(08) NOT NULL , ACCESS_LVL CHAR(01) NOT NULL , REC_TYPE CHAR(01) NOT NULL , CREATED_BY CHAR(08) NOT NULL , CREATED_TS TIMESTAMP NOT NULL ,

UPDATED_BY CHAR(08) NOT NULL , UPDATED_TS TIMESTAMP NOT NULL

Display_Panel

Detail_Panel

4. TopCoder Software Components N/A

5. Third Party Components N/A

3. Installation and Configuration

1. Package Name N/A 2. Configuration Parameters N/A 3. Dependencies Configuration N/A

4. Usage Notes
1. Required steps to test the component 1. Create few records in table with different scenario in such a way that data should traverse all the lines in the code. 2. Verify the Unit Test results.

4.3.7 Coding Standards

Please follow the below coding standards for developing the common module. 2. Test Cases Template The following test case template must be used for recording the test cases and their results accordingly.

5.Future Enhancements
N/A

Note: Primary Contact for this event is Aishwaryadevi Parthikumar/India/IBM@IBMIN