CSMS Message: 92-000789

Title:JCL FOR 2-WAY EMAIL (SDLC)
Date:1992-12-16
To:abi
Links:previous, next

TWO-WAY EMAIL PRODUCTION JCL
REQUIREMENTS FOR SDLC

THERE HAVE BEEN MANY QUESTIONS ABOUT JCL FOR 2-WAY EMAIL
MESSAGES USING SDLC COMMUNICATIONS. LISTED BELOW IS THE ENTIRE JCL
REQUIREMENTS TO BE USED FOR SDLC COMMUNICATIONS ON 2-WAY EMAIL.
THE DIFFERENCE BETWEEN BI-SYNC AND SDLC JCL ARE THE LOGON
STATEMENT VERSUS THE SIGNON CARD AND THE LOGOFF STATEMENT VERSUS
SIGNOFF CARD. THE ENTIRE JCL IS BEING REPEATED FOR YOUR
CONVENIENCE.

BASIC JOB CONTROL LANGUAGE (JCL) FOR SDLC COMMUNICATIONS

THIS IS THE BASIC SET OF JCL NEEDED FOR A REMOTE TO SUBMIT
TWO-WAY EMAIL JOBS. CUSTOMS USES THE FILE/RECORD NOMENCLATURE
TO DISTINGUISH THE DIFFERENT SEGMENTS OF THE JCL.

LOGON STATEMENT:
FOR SDLC COMMUNICATION SESSIONS, THE LOGON STATEMENT REPLACES THE
"/*SIGNON CARD" PREVIOUSLY USED. THIS LOGON STATEMENT MAY BE SET UP IN
A CLIENT'S RJE COMMUNICATION SOFTWARE. THE LOGON STATEMENT IS TO BE
FORMATTED AS FOLLOWS:

LOGON APPLID(JES2AS1) DATA(RMTNNNN,,PASSWORD)

THE NUMBER "NNNN" IS THE SDLC REMOTE NUMBER ASSIGNED TO THE
CLIENT'S RJE BY THE CUSTOMS DATA CENTER. THE "PASSWORD" IS THE EIGHT
DIGIT PASSWORD ASSIGNED TO THE CLIENT'S RJE BY THE CUSTOMS DATA CENTER.
BOTH OF THESE PARAMETERS WILL BE CONVEYED TO THE CLIENT BY THEIR
ASSIGNED ACS CLIENT REPRESENTATIVE. NOTE THE MANDATORY TWO COMMAS
SEPARATING THE REMOTE NUMBER AND THE PASSWORD.

FILE 1, RECORD 1

POSITIONS CONTENTS NAME / DESCRIPTION

1 - 2 // LITERAL. IDENTIFIES THIS RECORD AS
JCL TO MVS.

3 - 10 PTEBNNNN JOB NAME. PTEBNNNN IDENTIFIES THE JOB
TO MVS. THE "NNNN" MUST BE THE SAME
REMOTE NUMBER AS USED IN THE LOGON
PROCEDURE. THE JOB NAME MAY CHANGE TO
SUIT DIFFERENT CONDITIONS. USE
POSITIONS 7 THRU 9 FOR THREE DIGIT
REMOTE NUMBERS LEAVING POSITION 10 OF
THE RECORD BLANK. USE 7 AND 8 IF THE
REMOTE NUMBER IS ONLY TWO DIGITS LONG.

12 - 14 JOB LITERAL. IDENTIFIES THIS RECORD AS
THE MVS JOB STATEMENT.

16 - 27 (ABI0,4221), JOB ACCOUNTING INFORMATION. MAY
CHANGE IN THE FUTURE. THE CHARACTER
IN POSITION 20 IS A ZERO.

28 - 34 BROKER, LITERAL. ALL CLIENTS (IMPORTERS,
SERVICE BUREAUS, ETC.) SHOULD USE
THIS LITERAL.

35 - 42 CLASS=M, JOB CLASS. THE MVS JOB CLASS THAT
THE JOB WILL RUN IN. CAN CHANGE IN
THE FUTURE.

43 - 57 MSGLEVEL=(0,0), MESSAGE LEVEL. DETERMINES THE AMOUNT
OF REPORTING JES WILL RETURN TO
THE RJE STATION. NOTE THE DANGLING
COMMA SHOWS THAT THE JOB STATEMENT IS
CONTINUED ON THE NEXT RECORD. THE
CHARACTERS IN POSITIONS 53 AND 55 ARE
ZEROS.

FILE 1, RECORD 2

1 - 2 // LITERAL. IDENTIFIES THIS AS AN MVS
JCL RECORD.

15 - 25 MSGCLASS=D, MESSAGE CLASS. THIS CLASS SUPPRESSES
RETURNING ALMOST ALL THE JCL RESULTS
MESSAGES IF THE JOB SUCCESSFULLY
EXECUTES. MSGCLASS=D WILL RETURN JCL
RESULTS ONLY WHEN A PROBLEM OCCURS.

26 - 35 USER=RNNNN THE USER (REMOTE NUMBER) OF THE RJE.
THE "NNNN" IS THE REMOTE NUMBER
ASSIGNED TO YOUR REMOTE (NO LEADING
ZEROS). THREE DIGIT REMOTES LEAVE
POSITION 35 (THE LAST CHARACTER)
BLANK. TWO DIGIT REMOTES LEAVE
POSITIONS 34 AND 35 (THE LAST TWO
CHARACTERS) BLANK.

FILE 1, RECORD 3

1 - 2 // LITERAL. IDENTIFIES THIS RECORD AS
AN MVS JCL STATEMENT.

3 - 7 STEP1 STEP NAME. STEP1 IS THE NAME OF THIS
STEP WITH THE EXECUTION OF THE JOB.

10 - 13 EXEC LITERAL. IDENTIFIES THIS AS AN MVS
EXECUTE STATEMENT.

16 - 22 TEZZ01P PROC NAME. IDENTIFIES THE PROCEDURE
THAT THIS JOB WILL EXECUTE. THE
CHARACTER IN POSITION 20 IS A ZERO.

FILE 1, RECORD 4

1 - 5 //ABI LITERAL. IDENTIFIES THIS AS THE
SYSIN DATASET DEFINED WITH AS THE
TEZZ01 STEP OF THE PROC.

19 - 20 DD LITERAL. IDENTIFIES THIS RECORD AS A
DD (DATA DEFINITION) STATEMENT TO
MVS.

22 * LITERAL. THE ASTERISK IN THIS
CONTEXT TELLS MVS THAT THE DATA
IMMEDIATELY FOLLOWS THIS STATEMENT
AND IS NOT TAPE, DISK, ETC.

FILE 1, RECORD 5

1 - 80 TWO-WAY EMAIL THE CONTROL AND DATA RECORDS FOR
DATA TWO-WAY EMAIL ARE HERE (E.G.,
A, B, C0, C1, C2, M, Y, Z, ETC.)
REFER TO CATAIR FOR FORMAT OF THESE
RECORDS. LITERAL. IDENTIFIES THE
END OF THE DATASET DEFINED BY THE
PRECEDING DD STATEMENT. DOES NOT
CHANGE.

FILE 1, LAST RECORD

1 - 5 /*EOF LITERAL. IDENTIFIES THE END OF THE
DATASET DEFINED BY THE PREVIOUS DD
STATEMENT. THIS DOES NOT CHANGE.
THIS MUST BE THE LAST RECORD IN THIS
FILE.

LOGOFF STATEMENT:

CUSTOMS 377X SDLC PROTOCOL MAY USE ANY OF A VARIETY OF PROCEDURES
TO DISCONNECT CALLED "LOGGING OFF". THESE PROCEDURES ARE NOT
DISCUSSED IN DETAIL BECAUSE THEY ARE NORMALLY UNIQUE TO THE CLIENT'S
SDLC COMMUNICATIONS SOFTWARE. AN UNFORMATTED "LOGOFF" COMMAND MAY
ALTERNATELY BE USED TO TERMINATE THE COMMUNICATIONS SESSION.

IF YOU HAVE ANY QUESTIONS, PLEASE CONTACT YOUR CLIENT
REPRESENTATIVE OR KATHY COULTHARD AT 202-927-1130.