Right Adjust a Text String within a Field
|
Right Adjust, Zero Fill Right Adjust a Text String within a Field |
|
| The SimoTime Home Page |
Introduction
This suite of programs provides an example of a routine that will Right Adjust (or Right Justify) a numeric value within a text field and fill the left-most or high-order bytes with zeroes. The resulting field is also tested for numeric values and a return code (RA12-RESPOND) is set to zero (0) if numeric and eight (8) if not numeric. Two COBOL programs are provided. The first program is a demonstration program that reads a file containing "RIGHTADJ-info" records and calls the second COBOL program that actually does the right-adjust, zero-fill processing.
The objective of the right-adjust, zero-fill routine is to create a numeric field that will contain all digits with leading zeroes in the leftmost positions and be properly aligned to the units position. If the requirement is to right-justify, left-justify or center a text string within a field with the appropriate leading and/or trailing space characters then refer to the text-justification routine .
Both COBOL programs are written using the VS COBOL II dialect and also work with COBOL for MVS and COBOL/370. A JCL member is provided to run the job as an MVS batch job on an IBM mainframe or as a project with Micro Focus Mainframe Express (MFE) running on a PC with Windows. A Windows Command (.CMD) file is provided to run the job on a PC with Micro Focus Net Express. This program may serve as a tutorial for new programmers and as a reference for experienced programmers. Additional information is provided in the Downloads and Links to Similar Pages section of this document.
We have made a significant effort to ensure the documents and software technologies are correct and accurate. We reserve the right to make changes without notice at any time. The function delivered in this version is based upon the enhancement requests from a specific group of users. The intent is to provide changes as the need arises and in a timeframe that is dependent upon the availability of resources.
Copyright © 1987-2025
SimoTime Technologies and Services
All Rights Reserved
Programming Objectives
The following is a list of the functions provided in this example.
| ||||||||
| Program Objectives for the Right-Adjust Programs |
The first task performed by the SimoRA12 routine is to erase to the End-Of-Field. This feature will scan the field from left to right and erase (change to a space character) any characters after the first space is encountered. The next task is to right-adjust the non-space characters and zero-fill the leftmost (or high-order) bytes in the field. The final task is to test the results for a numeric value. If the resulting field is numeric the return code (or RA12-RESPOND) is set to zero, If the resulting field is not numeric the return code (or RA12-RESPOND) is set to 0008.
Programming Input and Output
The following is an example of the contents of the input or RIGHTADJ-info file (RA12GET1). Notice the 5th statement contains a non-numeric value. The 8th statement contains an embedded space that will cause the erase to End-Of-Field to remove (or erase) any characters after the embedded space character.
RIGHTADJ 1 RIGHTADJ 12 RIGHTADJ 123 RIGHTADJ 1234 RIGHTADJ 1234A RIGHTADJ 12345 RIGHTADJ 123456 RIGHTADJ 123 56789 RIGHTADJ 1234567 RIGHTADJ 12345678 RIGHTADJ 123456789 RIGHTADJ 1234567890 RIGHTADJ 12345678901 RIGHTADJ 123456789012 RIGHTADJ 3
The following is an example of the output file (RA12PUT1) based on the preceding RIGHTADJ-info file . Notice the 5th statement contains a non-numeric value. The 8th statement contains an embedded space that will cause the erase to End-Of-Field to remove (or erase) any characters after the embedded space character.
Right-Adjust, Zero-Fill Example v07.08.26 http://www.simotime.com Copyright 1987-2011 SimoTime Enterprises All Rights Reserved ******************************************************************** RIGHTADJ 1 Right Adjusted Value......... 000000000001 RC=0000, Value is Numeric ******************************************************************** RIGHTADJ 12 Right Adjusted Value......... 000000000012 RC=0000, Value is Numeric ******************************************************************** RIGHTADJ 123 Right Adjusted Value......... 000000000123 RC=0000, Value is Numeric ******************************************************************** RIGHTADJ 1234 Right Adjusted Value......... 000000001234 RC=0000, Value is Numeric ******************************************************************** RIGHTADJ 1234A Right Adjusted Value......... 00000001234A RC=0008, Value is NON-Numeric or Request Invalid ******************************************************************** RIGHTADJ 12345 Right Adjusted Value......... 000000012345 RC=0000, Value is Numeric ******************************************************************** RIGHTADJ 123456 Right Adjusted Value......... 000000123456 RC=0000, Value is Numeric ******************************************************************** RIGHTADJ 123 56789 Right Adjusted Value......... 000000000123 RC=0000, Value is Numeric ******************************************************************** RIGHTADJ 1234567 Right Adjusted Value......... 000001234567 RC=0000, Value is Numeric ******************************************************************** RIGHTADJ 12345678 Right Adjusted Value......... 000012345678 RC=0000, Value is Numeric ******************************************************************** RIGHTADJ 123456789 Right Adjusted Value......... 000123456789 RC=0000, Value is Numeric ******************************************************************** RIGHTADJ 1234567890 Right Adjusted Value......... 001234567890 RC=0000, Value is Numeric ******************************************************************** RIGHTADJ 12345678901 Right Adjusted Value......... 012345678901 RC=0000, Value is Numeric ******************************************************************** RIGHTADJ 123456789012 Right Adjusted Value......... 123456789012 RC=0000, Value is Numeric ******************************************************************** RIGHTADJ 3 Right Adjusted Value......... 000000000003 RC=0000, Value is Numeric RA12GET1 line count is 0000015 is Complete... Thank you for using this software provided from SimoTime Enterprises Please send all inquires or suggestions to the helpdesk@simotime.com
Programming Requirements
This suite of samples programs will run on the following platforms.
| ||||||
| Programming Requirements |
Programming Overview
The following diagram is an overview of how the demonstration program fits into the example. The demonstration program will read the RIGHTADJ info file (RA12GET1), call the right-adjust routine and write the results to the output file (RA12PUT1).
Color Associations: The
|
| ||||||||||||
| An Overview of the Structure of the Pass Area for calling SIMORA12 |
Batch Job Scripts
This section describes the batch job scripts that are used to create test data files and execute the test cases. A Job Script will identify and allocate resources (data files, memory, work areas, control information, etc.) for the Job or Job Step and execute programs that will process, access or utilize the allocated resources.
Windows CMD Files
This sample suite of programs has two CMD members. The first CMD member will execute the demonstration program. The second CMD member will create a RIGHTADJ info file.
Execute the Test Case
The following (CBLRAZE1.cmd) is the CMD that is required to run the demonstration program on a Windows System with Micro Focus Net Express.
@echo OFF
rem * *******************************************************************
rem * CBLRAZE1.cmd - a Windows Command File *
rem * This Job Script is provided by SimoTime Technologies *
rem * (C) Copyright 1987-2020 All Rights Reserved *
rem * Web Site URL: http://www.simotime.com *
rem * e-mail: helpdesk@simotime.com *
rem * *******************************************************************
rem *
rem * Text - Read file of Numeric strings, right-adjust, write output.
rem * Author - SimoTime Technologies
rem * Date - January 24, 1996
rem *
rem * The job will read an 80-byte file that contains RIGHTADJ
rem * information. The job will also write a file containing the results
rem * of the right-adjust functions.
rem *
rem * This set of programs will run on a mainframe under MVS or on a
rem * Personal Computer with Windows and Micro Focus Net Express.
rem *
rem * ************
rem * * CblRazE1 *
rem * ********cmd*
rem * *
rem * *
rem * ************
rem * * run *****************************
rem * ************ *
rem * * *
rem * * ************ ************ ************
rem * * * RA12GET1 ******* CblRazC1 ******* RA12PUT1 *
rem * * ********txt* ********cbl* ********csv*
rem * * *
rem * * ************
rem * * * SIMORA12 *
rem * * ********cbl*
rem * *
rem * ************
rem * * EOJ *
rem * ************
rem *
rem * *******************************************************************
rem * Step 1 Delete any previously created file...
rem *
rem *
call ..\Env1BASE
if "%SYSLOG%" == "" set syslog=c:\SimoLIBR\LOGS\SimoTime.LOG
set CmdName=CblRazE1
rem *
call SimoNOTE "*******************************************************%CmdName%"
call SimoNOTE "Starting CmdName %CmdName%"
:DeleteQSAM
call SimoNOTE "Identify JobStep DeleteQSAM"
set RA12GET1=%BaseLib1%\DATA\Asc1\RA12GET1.DAT
set RA12PUT1=%BaseLib1%\DATA\Wrk1\RA12PUT1.DAT
if exist %RA12PUT1% del %RA12PUT1%
rem *
rem * *******************************************************************
rem * Step 2 Edit input, create a new output file...
rem *
:ExecuteRightAdjustRoutine
call SimoNOTE "Identify JobStep ExecuteRightAdjustRoutine"
run CBLRAZC1
if not ERRORLEVEL = 0 set JobStatus=0001
if not %JobStatus% == 0000 goto :EojNok
rem *
if exist %RA12PUT1% goto :EojAok
set JobStatus=0002
goto :EojNok
:EojAok
call SimoNOTE "Produced DataSet %RA12PUT1%"
call SimoNOTE "Finished CmdName %CmdName%, Job Status is %JobStatus%"
goto :End
:EojNok
call SimoNOTE "ABENDING CmdName %CmdName%, Job Status is %JobStatus%"
:End
call SimoNOTE "Conclude SysLog is %SYSLOG%"
if not "%SIMOMODE%" == "BATCH" pause
Create the Test Data File
The following (CBLRAZE2.cmd) is the CMD that may be used to create a RIGHTADJ-info file.
@echo OFF
rem * *******************************************************************
rem * CBLRAZE2.cmd - a Windows Command File *
rem * This Job Script is provided by SimoTime Technologies *
rem * (C) Copyright 1987-2019 All Rights Reserved *
rem * Web Site URL: http://www.simotime.com *
rem * e-mail: helpdesk@simotime.com *
rem * *******************************************************************
rem *
rem * Text - Create a Sequential Data Set on disk using Echo command.
rem * Author - SimoTime Technologies
rem * Date = January 24, 1996
rem *
rem * The first job step (DeleteQSAM) will delete any previously created
rem * file. The second job step (CreateQSAM) will create a new file.
rem *
rem * This set of programs will run on a Personal Computer with Windows
rem * and Micro Focus Net Express.
rem *
call ..\ENV1BASE
if "%SYSLOG%" == "" set syslog=c:\SimoLIBR\LOGS\SimoTime.LOG
set JobName=CblRazE2
rem *
call SimoNOTE "*******************************************************%JobName%"
call SimoNOTE "Starting JobName %JobName%"
call SimoNOTE "Identify JobStep DeleteQSAM"
set RA12TXT1=%BaseLib1%\DATA\Txt1\RA12TXT1.TXT
if exist %RA12TXT1% del %RA12TXT1%
rem *
rem * *******************************************************************
rem * Step 2 of 2 Create and populate a new QSAM file...
rem *
:CreateLSEQ
call SimoNOTE "Identify JobStep CreateLSEQ"
rem * ..1....:....2....:....3....:....4....:....5....:....6....:....7.
echo RIGHTADJ 1 >%RA12TXT1%
echo RIGHTADJ 12 >>%RA12TXT1%
echo RIGHTADJ 123 >>%RA12TXT1%
echo RIGHTADJ 1234 >>%RA12TXT1%
echo RIGHTADJ 1234A >>%RA12TXT1%
echo RIGHTADJ 12345 >>%RA12TXT1%
echo RIGHTADJ 123456 >>%RA12TXT1%
echo RIGHTADJ 123 56 >>%RA12TXT1%
echo RIGHTADJ 1234567 >>%RA12TXT1%
echo RIGHTADJ 12345678 >>%RA12TXT1%
echo RIGHTADJ 123456789 >>%RA12TXT1%
echo RIGHTADJ 1234567890 >>%RA12TXT1%
echo RIGHTADJ 12345678901 >>%RA12TXT1%
echo RIGHTADJ 123456789012 >>%RA12TXT1%
echo RIGHTADJ 3 >>%RA12TXT1%
if exist %RA12TXT1% call SimoNOTE "Produced DataSet %RA12TXT1%"
if not exist %RA12TXT1% set JobStatus=9001
if not %JobStatus% == 0000 goto :EojNok
:CreateRSEQAsc
set GETLS080=%BaseLib1%\DATA\TXT1\RA12TXT1.TXT
set PUTRS080=%BaseLib1%\DATA\Asc1\RA12GET1.DAT
if exist %PUTRS080% del %PUTRS080%
run CV80ALAR
if exist %PUTRS080% call SimoNOTE "Produced DataSet %PUTRS080%"
if not exist %PUTRS080% set JobStatus=9002
if not %JobStatus% == 0000 goto :EojNok
:CreateRSEQEbc
set GETLS080=%BaseLib1%\DATA\TXT1\RA12TXT1.TXT
set PUTRS080=%BaseLib1%\DATA\Ebc1\RA12GET1.DAT
if exist %PUTRS080% del %PUTRS080%
run CV80ALER
if exist %PUTRS080% call SimoNOTE "Produced DataSet %PUTRS080%"
if not exist %PUTRS080% set JobStatus=9003
if not %JobStatus% == 0000 goto :EojNok
rem *
:EojAok
call SimoNOTE "Finished JobName %JobName%, Job Status is %JobStatus%"
goto :End
:EojNok
call SimoNOTE "NOTE ABENDING JobName %JobName%, Job Status is %JobStatus%"
:End
call SimoNOTE "Conclude SYSOUT is %SYSOUT%"
if not "%SIMOMODE%" == "BATCH" pause
Mainframe JCL Members
This sample suite of programs has two JCL members. The first JCL member will execute the demonstration program. The second JCL member will create a RIGHTADJ info file.
Execute the Test Case
The following (CBLRAZJ1.jcl) is the JCL member that is required to run the demonstration program on a Mainframe System with ZOS or a Linux, UNIX or Windows System with Micro Focus Enterprise Server.
//CBLRAZJ1 JOB SIMOTIME,CLASS=1,MSGCLASS=0,NOTIFY=CSIP1 //* ******************************************************************* //* CBLRAZJ1.JCL - a JCL Member for Batch Job Processing * //* This JCL Member is provided by SimoTime Technologies * //* (C) Copyright 1987-2019 All Rights Reserved * //* Web Site URL: http://www.simotime.com * //* e-mail: helpdesk@simotime.com * //* ******************************************************************* //* //* Text - Read a file of RIGHTADJ Info, right adjust, write output. //* Author - SimoTime Technologies //* Date - January 24, 1996 //* //* The job will read an 80-byte file that contains RIGHT-ADJUST //* information. The job will also write a file containing the results //* of the right adjust functions.. //* //* This set of programs will run on a mainframe under MVS or on a //* Personal Computer with Windows and Micro Focus Mainframe Express. //* //* ************ //* * CBLRAZJ1 * //* ********jcl* //* * //* ************ //* * IEFBR14 * //* ********utl* //* * //* ************ ************ ************ //* * RA12GET1 *-----* CBLRAZC1 *-----* RA12PUT1 * //* ********dat* ********cbl* ********dat* //* * * //* * * ************ //* * *-call--* SIMORA12 * //* * ********cbl* //* * //* ************ //* * EOJ * //* ************ //* //* ******************************************************************* //* Step 1 of 2, Delete any previously created file... //* //JOBSETUP EXEC PGM=IEFBR14 //RA12PUT1 DD DSN=SIMOTIME.DATA.RA12PUT1,DISP=(MOD,DELETE,DELETE), // STORCLAS=MFI, // SPACE=(TRK,5), // DCB=(RECFM=FB,LRECL=80,BLKSIZE=800,DSORG=PS) //* //* ******************************************************************* //* Step 2 of 2, Right adjust input, create a new output file... //* //RIGHTADJ EXEC PGM=CBLRAZC1 //STEPLIB DD DSN=SIMOTIME.DEMO.LOADLIB1,DISP=SHR //RA12GET1 DD DSN=SIMOTIME.DATA.RA12GET1,DISP=SHR //RA12PUT1 DD DSN=SIMOTIME.DATA.RA12PUT1, // DISP=(NEW,CATLG,DELETE), // STORCLAS=MFI, // SPACE=(TRK,5), // DCB=(RECFM=FB,LRECL=80,BLKSIZE=800,DSORG=PS) //SYSOUT DD SYSOUT=* //
Create the Test Data File
The following (CBLRAZJ2.jcl) is the JCL member that may be used to create a RIGHTADJ file to be used for testing.
//CBLRAZJ2 JOB SIMOTIME,CLASS=1,MSGCLASS=0,NOTIFY=CSIP1 //* ******************************************************************* //* CBLRAZJ2.JCL - a JCL Member for Batch Job Processing * //* This JCL Member is provided by SimoTime Technologies * //* (C) Copyright 1987-2019 All Rights Reserved * //* Web Site URL: http://www.simotime.com * //* e-mail: helpdesk@simotime.com * //* ******************************************************************* //* //* Text - Create a Sequential Data Set on disk using IEBGENER. //* Author - SimoTime Technologies //* Date - January 24, 1996 //* //* The first job step (QSAMDELT) will delete any previously created //* file. The second job step (QCRTDIN1) will create a new file. //* //* This set of programs will run on a mainframe under MVS or on a //* Personal Computer with Windows and Micro Focus Mainframe Express. //* //* ******************************************************************* //* Step 1 of 2, Delete any previously created file... //* //JOBSETUP EXEC PGM=IEFBR14 //SYSUT2 DD DSN=SIMOTIME.DATA.RA12GET1,DISP=(MOD,DELETE,DELETE), // STORCLAS=MFI, // SPACE=(TRK,5), // DCB=(RECFM=FB,LRECL=80,BLKSIZE=800,DSORG=PS) //* //* ******************************************************************* //* Step 2 of 2, Create and populate a new QSAM file... //* //BUILDNEW EXEC PGM=IEBGENER //SYSPRINT DD SYSOUT=* //SYSIN DD DUMMY //* :....1....:....2....:....3....:....4....:....5....:....6....:....7. //SYSUT1 DD * RIGHTADJ 1 RIGHTADJ 12 RIGHTADJ 123 RIGHTADJ 1234 RIGHTADJ 1234A RIGHTADJ 12345 RIGHTADJ 123456 RIGHTADJ 123 56789 RIGHTADJ 1234567 RIGHTADJ 12345678 RIGHTADJ 123456789 RIGHTADJ 1234567890 RIGHTADJ 12345678901 RIGHTADJ 123456789012 RIGHTADJ 3 /* //SYSUT2 DD DSN=SIMOTIME.DATA.RA12GET1, // DISP=(NEW,CATLG,DELETE), // STORCLAS=MFI, // SPACE=(TRK,5), // DCB=(RECFM=FB,LRECL=80,BLKSIZE=800,DSORG=PS) //
Bash Script Files
This set of job scripts for a Linux or UNIX System has two Bash Scripts. The first Bash Script will execute the demonstration program. The second Bash Script will create the test files used by the first Bash Script as input.
Execute the Test Case
The following (cblrazs1.sh) is the Bash Script File that is required to run this test case on a Linux System with GnuCOBOL.
#!/bin/bash
JOBNAME=cblrazs1
# * *******************************************************************
# * Bash Script File - provided by SimoTime Technologies *
# * (C) Copyright 1987-2018 All Rights Reserved *
# * Web Site URL: http://www.simotime.com *
# * e-mail: helpdesk@simotime.com *
# * *******************************************************************
# *
# * Text - Right-Justify, Zero-Fill Numeric String within a Field
# * Author - SimoTime Technologies
# * Date - November 11, 2003
# * Version - 06.07.16
# *
# * Prepare the environment by mapping the file names.
# * Execute the 80/80 copy file program.
# *
# * ********************************************************************
# * Step 1 of 3, Prepare the System Environment.
# *
JOBSTATUS=0
for textstring in $(cat ENV4SYS1.txt);
do
# # * The following statement will replace all occurences
# # * of DL_BASESYS1 with the value of the BASESYS1
# # * environment variable.
textstring=${textstring//DL_BASESYS1/$BASESYS1}
# # * The following statement will replace all occurences
# # * of BASHUSER_JOBNAME with the value of the JOBNAME
# # * environment variable.
textstring=${textstring/DL_JOBNAME/$JOBNAME}
export $textstring
rc=$?
if [ $rc != 0 ]
then
simonote.sh "# $textstring - Return Code is $rc"
JOBSTATUS=$rc
fi
done
# *
simonote.sh "************************************************************$JOBNAME"
simonote.sh "# Starting Job Name $JOBNAME"
simonote.sh "# SIMOSYS1........... $BASESYS1"
simonote.sh "# SIMONOTE........... $SIMONOTE"
simonote.sh "# COB_LIBS........... $COB_LIBS"
simonote.sh "# COB_LIBRARY_PATH... $COB_LIBRARY_PATH"
# *
# * Prepare the environment, map the file names...
export RA12GET1=$BASESYS1/SIMOSAM1/DEVL/DATA/APPL/SIMOTIME.DATA.RA12RS80.dat
export RA12PUT1=$BASESYS1/SIMOSAM1/DEVL/DATA/APPL/SIMOTIME.DATA.RA12PUT1.dat
simonote.sh "# DATATAKE is $RA12GET1"
simonote.sh "# DATAMAKE is $RA12PUT1"
# *
# * ********************************************************************
# * Step 2 of 3, Run the program.
# *
if [ -f "$RA12PUT1" ]
then
rm $RA12PUT1
fi
cobcrun CBLRAZC1 | tee $BASESYS1/SIMOSAM1/DEVL/LOGS/SYSOUT_USERPROG_CBLRAZC1.txt
rc=$?
if [ $rc != 0 ]
then
simonote.sh "# ABENDING $name - Return Code is $rc"
JOBSTATUS=$rc
else
((AOK_Count++))
fi
# *
# * ********************************************************************
# * Step 3 of 3, End of Job Processing.
# *
if [ "$JOBSTATUS" = "0" ]
then
simonote.sh "# Finished Job Name $JOBNAME"
else
simonote.sh "# ABENDING Job Name $JOBNAME"
fi
Create the Test Data File
The following (cblrazs2.sh) is the Bash Script File that may be used to create a RIGHTADJ file to be used for testing.
#!/bin/bash
JOBNAME=cblrazs2
# *********************************************************************
# * Bash Script File - provided by SimoTime Technologies *
# * (C) Copyright 1987-2018 All Rights Reserved *
# * Web Site URL: http://www.simotime.com *
# * e-mail: helpdesk@simotime.com *
# *********************************************************************
# *
# * Text - Create Test Files.
# * Author - SimoTime Technologies
# * Date = January 24, 1996
# *
# * The 1ST step will delete a previously created file and then
# * create a new ASCII/Text file.
# * The 2ND step will convert the Line Sequential file to a Record
# * Sequential file and keep the ASCII encoding.
# * The 3RD step will convert the Line Sequential file to a Record
# * Sequential file and convert the record content from ASCII to EBCDIC
# *
# * This set of programs will run on a Linux System with GnuCOBOL.
# *
# * ********************************************************************
# * Step 1 of 3, Prepare the System Environment.
# *
JOBSTATUS=0
for textstring in $(cat ENV4SYS1.txt);
do
# # * The following statement will replace all occurences
# # * of DL_BASESYS1 with the value of the BASESYS1
# # * environment variable.
textstring=${textstring//DL_BASESYS1/$BASESYS1}
# # * The following statement will replace all occurences
# # * of BASHUSER_JOBNAME with the value of the JOBNAME
# # * environment variable.
textstring=${textstring/DL_JOBNAME/$JOBNAME}
export $textstring
rc=$?
if [ $rc != 0 ]
then
simonote.sh "# $textstring - Return Code is $rc"
JOBSTATUS=$rc
fi
done
# *
simonote.sh "************************************************************$JOBNAME"
echo "# SIMOSYS1........... $BASESYS1"
echo "# SIMONOTE........... $SIMONOTE"
echo "# COB_LIBS........... $COB_LIBS"
echo "# COB_LIBRARY_PATH... $COB_LIBRARY_PATH"
simonote.sh "StepInfo Delete previously created files"
export RA12TXT1=$BASESYS1/SIMOSAM1/DEVL/DATA/TXT1/RA12TXT1.txt
# *
# * *******************************************************************
# * Step 1 of 3 Create and populate a new ASCII/TEXT file...
# *
simonote.sh "StepInfo Create an ASCII/Text File"
if [ -f "$RA12TXT1" ]
then
rm $RA12TXT1
fi
# * ....:....1....:....2....:....3....:....4....:....5....:....6....:....7.
echo "RIGHTADJ 1 ">$RA12TXT1
echo "RIGHTADJ 12 ">>$RA12TXT1
echo "RIGHTADJ 123 ">>$RA12TXT1
echo "RIGHTADJ 1234 ">>$RA12TXT1
echo "RIGHTADJ 1234A ">>$RA12TXT1
echo "RIGHTADJ 12345 ">>$RA12TXT1
echo "RIGHTADJ 123456 ">>$RA12TXT1
echo "RIGHTADJ 123 56 ">>$RA12TXT1
echo "RIGHTADJ 1234567 ">>$RA12TXT1
echo "RIGHTADJ 12345678 ">>$RA12TXT1
echo "RIGHTADJ 123456789 ">>$RA12TXT1
echo "RIGHTADJ 1234567890 ">>$RA12TXT1
echo "RIGHTADJ 12345678901 ">>$RA12TXT1
echo "RIGHTADJ 123456789012 ">>$RA12TXT1
echo "RIGHTADJ 3 ">>$RA12TXT1
# *
if [ -f "$RA12TXT1" ]
then
simonote.sh "RA12TXT1 is $RA12TXT1"
else
simonote.sh "ABENDING File not created, $RA12TXT1"
exit 9001
fi
# *
# * *******************************************************************
# * Step 2 of 3, Convert ASCII/TEXT file to ASCII RSEQ File...
# *
simonote.sh "StepInfo Convert Line Sequential to ASC Record Sequential"
export GETLS080=$RA12TXT1
export PUTRS080=$BASESYS1/SIMOSAM1/DEVL/DATA/APPL/SIMOTIME.DATA.RA12RS80.dat
if [ -f "$PUTRS080" ]
then
rm $PUTRS080
fi
cobcrun CV80ALAR
rc=$?
if [ $rc != 0 ]
then
simonote.sh "+ $name - Return Code is $rc"
JOBSTATUS=$rc
simonote.sh "ABENDING Job Name is $JOBNAME, Job Status is $JOBSTATUS"
exit $JOBSTATUS
else
simonote.sh "DataTake $GETLS080"
simonote.sh "DataMake $PUTRS080"
fi
# *
# * *******************************************************************
# * Step 3 of 3 Convert ASCII/TEXT file to EBCDIC RSEQ File...
# *
simonote.sh "StepInfo Convert Line Sequential to EBC Record Sequential"
export GETLS080=$RA12TXT1
export PUTRS080=$BASESYS1/SIMOSAM1/DEVL/DATA/EBC1/SIMOTIME.DATA.RA12RS80.dat
if [ -f "$PUTRS080" ]
then
rm $PUTRS080
fi
cobcrun CV80ALER
rc=$?
if [ $rc != 0 ]
then
simonote.sh "+ $name - Return Code is $rc"
JOBSTATUS=$rc
simonote.sh "ABENDING Job Name is $JOBNAME, Job Status is $JOBSTATUS"
exit $JOBSTATUS
else
simonote.sh "DataTake $GETLS080"
simonote.sh "DataMake $PUTRS080"
fi
# *
if [ "$JOBSTATUS" = "0" ]
then
simonote.sh "Finished Job Name $JOBNAME"
else
simonote.sh "ABENDING Job Name $JOBNAME"
fi
COBOL Program Members
This section describes the COBOL Members that are are included in this test case.
The Mainline Program
The following (CBLRAZC1.cbl) is the COBOL source code for the demonstration program.
IDENTIFICATION DIVISION.
PROGRAM-ID. CBLRAZC1.
*AUTHOR. SIMOTIME TECHNOLOGIES.
*****************************************************************
* Copyright (C) 1987-2019 SimoTime Technologies. *
* *
* All rights reserved. Unpublished, all rights reserved under *
* copyright law and international treaty. Use of a copyright *
* notice is precautionary only and does not imply publication *
* or disclosure. *
* *
* Permission to use, copy, modify and distribute this software *
* for any commercial purpose requires a fee to be paid to *
* SimoTime Technologies. Once the fee is received by SimoTime *
* the latest version of the software will be delivered and a *
* license will be granted for use within an enterprise, *
* provided the SimoTime copyright notice appear on all copies *
* of the software. The SimoTime name or Logo may not be used *
* in any advertising or publicity pertaining to the use of the *
* software without the written permission of SimoTime *
* Technologies. *
* *
* Permission to use, copy and modify this software for any *
* non-commercial purpose and without fee is hereby granted, *
* provided the SimoTime copyright notice appear on all copies *
* of the software. The SimoTime name or Logo may not be used in *
* any advertising or publicity pertaining to the use of the *
* software without the written permission of SimoTime *
* Technologies. *
* *
* SimoTime Technologies makes no warranty or representations *
* about the suitability of the software for any purpose. It is *
* provided "AS IS" without any expressed or implied warranty, *
* including the implied warranties of merchantability, fitness *
* for a particular purpose and non-infringement. SimoTime *
* Technologies shall not be liable for any direct, indirect, *
* special or consequential damages resulting from the loss of *
* use, data or projects, whether in an action of contract or *
* tort, arising out of or in connection with the use or *
* performance of this software *
* *
* SimoTime Technologies *
* 15 Carnoustie Drive *
* Novato, CA 94949-5849 *
* 415.883.6565 *
* *
* RESTRICTED RIGHTS LEGEND *
* Use, duplication, or disclosure by the Government is subject *
* to restrictions as set forth in subparagraph (c)(1)(ii) of *
* the Rights in Technical Data and Computer Software clause at *
* DFARS 52.227-7013 or subparagraphs (c)(1) and (2) of *
* Commercial Computer Software - Restricted Rights at 48 *
* CFR 52.227-19, as applicable. Contact SimoTime Technologies, *
* 15 Carnoustie Drive, Novato, CA 94949-5849. *
* *
*****************************************************************
* This program is provided by SimoTime Technologies *
* Our e-mail address is: helpdesk@simotime.com *
* Also, visit our Web Site at http://www.simotime.com *
*****************************************************************
* Source Member: CBLRAZC1.CBL
* Copy Files: PASSRA12.CPY
* Calls to: SIMORA12
*****************************************************************
*
* ************
* * CBLRAZJ1 *
* ********jcl*
* *
* ************
* * IEFBR14 *
* ********utl*
* *
* ************ ************ ************
* * RA12GET1 *-----* CBLRAZC1 *-----* RA12PUT1 *
* ********dat* ********cbl* ********dat*
* * *
* * * ************
* * *-call--* SIMORA12 *
* * ********cbl*
* *
* ************
* * EOJ *
* ************
*
*****************************************************************
ENVIRONMENT DIVISION.
INPUT-OUTPUT SECTION.
FILE-CONTROL.
SELECT RA12GET1-FILE ASSIGN to RA12GET1
ORGANIZATION is SEQUENTIAL
ACCESS MODE is SEQUENTIAL
FILE STATUS is RA12GET1-STATUS.
SELECT RA12PUT1-FILE ASSIGN to RA12PUT1
ORGANIZATION is SEQUENTIAL
ACCESS MODE is SEQUENTIAL
FILE STATUS is RA12PUT1-STATUS.
*****************************************************************
DATA DIVISION.
FILE SECTION.
FD RA12GET1-FILE
DATA RECORD is RA12GET1-RECORD.
01 RA12GET1-RECORD.
05 RA12GET1-DATA-01.
10 RA12GET1-KEYWORD pic X(0008).
10 RA12GET1-BLANK pic X.
10 RA12GET1-INFO pic X(71).
FD RA12PUT1-FILE
DATA RECORD is RA12PUT1-RECORD.
01 RA12PUT1-RECORD.
05 RA12PUT1-DATA-01 pic X(00080).
*****************************************************************
WORKING-STORAGE SECTION.
01 SIM-TITLE.
05 T1 pic X(11) value '* CBLRAZC1 '.
05 T2 pic X(34) value 'Right-Adjust, Zero-Fill Example '.
05 T3 pic X(10) value ' v07.08.26'.
05 T4 pic X(24) value ' http://www.simotime.com'.
01 SIM-COPYRIGHT.
05 C1 pic X(11) value '* CBLRAZC1 '.
05 C2 pic X(20) value 'Copyright 1987-2019 '.
05 C3 pic X(28) value ' SimoTime Technologies '.
05 C4 pic X(20) value ' All Rights Reserved'.
01 SIM-THANKS-01.
05 C1 pic X(11) value '* CBLRAZC1 '.
05 C2 pic X(32) value 'Thank you for using this program'.
05 C3 pic X(32) value ' provided from SimoTime Technolo'.
05 C4 pic X(04) value 'gies'.
01 SIM-THANKS-02.
05 C1 pic X(11) value '* CBLRAZC1 '.
05 C2 pic X(32) value 'Please send all inquires or sugg'.
05 C3 pic X(32) value 'estions to the helpdesk@simotime'.
05 C4 pic X(04) value '.com'.
01 MESSAGE-BUFFER.
05 MESSAGE-HEADER pic X(11) value '* CBLRAZC1 '.
05 MESSAGE-TEXT.
10 MESSAGE-TEXT-1 pic X(68) value SPACES.
10 MESSAGE-TEXT-2 pic X(188) value SPACES.
01 RA12GET1-STATUS.
05 RA12GET1-STATUS-L pic X.
05 RA12GET1-STATUS-R pic X.
01 RA12GET1-EOF pic X value 'N'.
01 RA12GET1-OPEN-FLAG pic X value 'C'.
01 RA12PUT1-STATUS.
05 RA12PUT1-STATUS-L pic X.
05 RA12PUT1-STATUS-R pic X.
01 RA12PUT1-EOF pic X value 'N'.
01 RA12PUT1-OPEN-FLAG pic X value 'C'.
01 IO-STATUS.
05 IO-STAT1 pic X.
05 IO-STAT2 pic X.
01 TWO-BYTES.
05 TWO-BYTES-LEFT pic X.
05 TWO-BYTES-RIGHT pic X.
01 TWO-BYTES-BINARY redefines TWO-BYTES pic 9(4) comp.
01 APPL-RESULT pic S9(9) comp.
88 APPL-AOK value 0.
88 APPL-EOF value 16.
01 RA12GET1-TOTAL.
05 filler pic X(23) value 'RA12GET1 line count is '.
05 RA12GET1-LOC pic 9(7) value 0.
*****************************************************************
* The following copy file of the pass area for calling SimoRA12,
* the date editing routine.
*****************************************************************
*
COPY PASSRA12.
*
*****************************************************************
PROCEDURE DIVISION.
perform Z-POST-COPYRIGHT
perform RA12GET1-OPEN
perform RA12PUT1-OPEN
perform until RA12GET1-STATUS not = '00'
perform RA12GET1-READ
if RA12GET1-STATUS = '00'
add 1 to RA12GET1-LOC
perform RIGHT-ADJUST-FUNCTION-DOIT
perform RIGHT-ADJUST-FUNCTION-DISPLAY
end-if
end-perform
move RA12GET1-TOTAL to MESSAGE-TEXT
perform Z-DISPLAY-CONSOLE-MESSAGE
if RA12GET1-EOF = 'Y'
move 'is Finished...' to MESSAGE-TEXT
else
move 'is ABENDING...' to MESSAGE-TEXT
end-if
perform Z-DISPLAY-CONSOLE-MESSAGE
perform RA12PUT1-CLOSE
perform RA12GET1-CLOSE
perform Z-THANK-YOU.
GOBACK.
*****************************************************************
* The following routines are in alphabetical sequence.. *
*****************************************************************
RIGHT-ADJUST-FUNCTION-DISPLAY.
move 'Right Adjusted Value......... ' to MESSAGE-TEXT
move RA12-BUFFER to MESSAGE-TEXT(31:12)
move MESSAGE-TEXT to RA12PUT1-DATA-01
perform Z-DISPLAY-CONSOLE-MESSAGE
perform RA12PUT1-WRITE
if RA12-RESPOND = ZERO
move 'RC=nnnn, Value is Numeric' to MESSAGE-TEXT
else
move 'RC=nnnn, Value is NON-Numeric or Request Invalid'
to MESSAGE-TEXT
end-if
move RA12-RESPOND to MESSAGE-TEXT(4:4)
move MESSAGE-TEXT to RA12PUT1-DATA-01
perform Z-DISPLAY-CONSOLE-MESSAGE
perform RA12PUT1-WRITE
exit.
*
*****************************************************************
RIGHT-ADJUST-FUNCTION-DOIT.
move all '*' to MESSAGE-TEXT-1
perform Z-DISPLAY-CONSOLE-MESSAGE
move all '*' to RA12PUT1-DATA-01
perform RA12PUT1-WRITE
move RA12GET1-DATA-01 to MESSAGE-TEXT
perform Z-DISPLAY-CONSOLE-MESSAGE
move RA12GET1-DATA-01 to RA12PUT1-DATA-01
perform RA12PUT1-WRITE
move 'RIGHTADJ' to RA12-REQUEST
move RA12GET1-INFO to RA12-BUFFER
call 'SIMORA12' using RA12-PASS-AREA
exit.
*****************************************************************
* I/O ROUTINES FOR RA12GET1... *
*****************************************************************
RA12GET1-CLOSE.
add 8 to ZERO giving APPL-RESULT.
close RA12GET1-FILE
if RA12GET1-STATUS = '00'
subtract APPL-RESULT from APPL-RESULT
else
add 12 to ZERO giving APPL-RESULT
end-if
if APPL-AOK
CONTINUE
else
move 'RA12GET1-Failure-CLOSE...' to MESSAGE-TEXT
perform Z-DISPLAY-CONSOLE-MESSAGE
move RA12GET1-STATUS to IO-STATUS
perform Z-DISPLAY-IO-STATUS
perform Z-ABEND-PROGRAM
end-if
exit.
*---------------------------------------------------------------*
RA12GET1-READ.
read RA12GET1-FILE
if RA12GET1-STATUS = '00'
subtract APPL-RESULT from APPL-RESULT
else
if RA12GET1-STATUS = '10'
add 16 to ZERO giving APPL-RESULT
else
add 12 to ZERO giving APPL-RESULT
end-if
end-if
if APPL-AOK
CONTINUE
else
if APPL-EOF
move 'Y' to RA12GET1-EOF
else
move 'RA12GET1-Failure-GET...' to MESSAGE-TEXT
perform Z-DISPLAY-CONSOLE-MESSAGE
move RA12GET1-STATUS to IO-STATUS
perform Z-DISPLAY-IO-STATUS
perform Z-ABEND-PROGRAM
end-if
end-if
exit.
*---------------------------------------------------------------*
RA12GET1-OPEN.
add 8 to ZERO giving APPL-RESULT.
open input RA12GET1-FILE
if RA12GET1-STATUS = '00'
subtract APPL-RESULT from APPL-RESULT
move 'O' to RA12GET1-OPEN-FLAG
else
add 12 to ZERO giving APPL-RESULT
end-if
if APPL-AOK
CONTINUE
else
move 'RA12GET1-Failure-OPEN...' to MESSAGE-TEXT
perform Z-DISPLAY-CONSOLE-MESSAGE
move RA12GET1-STATUS to IO-STATUS
perform Z-DISPLAY-IO-STATUS
perform Z-ABEND-PROGRAM
end-if
exit.
*****************************************************************
* I/O ROUTINES FOR RA12PUT1... *
*****************************************************************
RA12PUT1-WRITE.
if RA12PUT1-OPEN-FLAG = 'C'
perform RA12PUT1-OPEN
end-if
write RA12PUT1-RECORD
if RA12PUT1-STATUS = '00'
subtract APPL-RESULT from APPL-RESULT
else
if RA12PUT1-STATUS = '10'
add 16 to ZERO giving APPL-RESULT
else
add 12 to ZERO giving APPL-RESULT
end-if
end-if.
if APPL-AOK
CONTINUE
else
move 'RA12PUT1-Failure-WRITE...' to MESSAGE-TEXT
perform Z-DISPLAY-CONSOLE-MESSAGE
move RA12PUT1-STATUS to IO-STATUS
perform Z-DISPLAY-IO-STATUS
perform Z-ABEND-PROGRAM
end-if
exit.
*---------------------------------------------------------------*
RA12PUT1-OPEN.
add 8 to ZERO giving APPL-RESULT.
open output RA12PUT1-FILE
if RA12PUT1-STATUS = '00'
subtract APPL-RESULT from APPL-RESULT
move 'O' to RA12PUT1-OPEN-FLAG
else
add 12 to ZERO giving APPL-RESULT
end-if
if APPL-AOK
CONTINUE
else
move 'RA12PUT1-Failure-OPEN...' to MESSAGE-TEXT
perform Z-DISPLAY-CONSOLE-MESSAGE
move RA12PUT1-STATUS to IO-STATUS
perform Z-DISPLAY-IO-STATUS
perform Z-ABEND-PROGRAM
end-if
exit.
*---------------------------------------------------------------*
RA12PUT1-CLOSE.
add 8 to ZERO giving APPL-RESULT.
close RA12PUT1-FILE
if RA12PUT1-STATUS = '00'
subtract APPL-RESULT from APPL-RESULT
move 'C' to RA12PUT1-OPEN-FLAG
else
add 12 to ZERO giving APPL-RESULT
end-if
if APPL-AOK
CONTINUE
else
move 'RA12PUT1-Failure-CLOSE...' to MESSAGE-TEXT
perform Z-DISPLAY-CONSOLE-MESSAGE
move RA12PUT1-STATUS to IO-STATUS
perform Z-DISPLAY-IO-STATUS
perform Z-ABEND-PROGRAM
end-if
exit.
*****************************************************************
* The following Z-Routines perform administrative tasks *
* for this program. *
*****************************************************************
* ABEND the program, post a message to the console and issue *
* a STOP RUN. *
*****************************************************************
Z-ABEND-PROGRAM.
if MESSAGE-TEXT not = SPACES
perform Z-DISPLAY-CONSOLE-MESSAGE
end-if
move 'PROGRAM-IS-ABENDING...' to MESSAGE-TEXT
perform Z-DISPLAY-CONSOLE-MESSAGE
add 12 to ZERO giving RETURN-CODE
STOP RUN.
* exit.
*****************************************************************
* Display CONSOLE messages... *
*****************************************************************
Z-DISPLAY-CONSOLE-MESSAGE.
if MESSAGE-TEXT-2 = SPACES
display MESSAGE-BUFFER(1:79) upon console
else
display MESSAGE-BUFFER upon console
end-if
move all SPACES to MESSAGE-TEXT
exit.
*****************************************************************
* Display the file status bytes. This routine will display as *
* two digits if the full two byte file status is numeric. If *
* second byte is non-numeric then it will be treated as a *
* binary number. *
*****************************************************************
Z-DISPLAY-IO-STATUS.
if IO-STATUS not NUMERIC
or IO-STAT1 = '9'
subtract TWO-BYTES-BINARY from TWO-BYTES-BINARY
move IO-STAT2 to TWO-BYTES-RIGHT
display '* CBLRAZC1 File-Status-' IO-STAT1 '/'
TWO-BYTES-BINARY upon console
else
display '* CBLRAZC1 File-Status-' IO-STATUS upon console
end-if
exit.
*****************************************************************
Z-POST-COPYRIGHT.
display SIM-TITLE upon console
display SIM-COPYRIGHT upon console
exit.
*****************************************************************
Z-THANK-YOU.
display SIM-THANKS-01 upon console
display SIM-THANKS-02 upon console
exit.
*****************************************************************
* This example is provided by SimoTime Technologies *
* Our e-mail address is: helpdesk@simotime.com *
* Also, visit our Web Site at http://www.simotime.com *
*****************************************************************
The Right-Adjust Routine
The following (SIMORA12.cbl) is the COBOL source code for the demonstration program.
IDENTIFICATION DIVISION.
PROGRAM-ID. SIMORA12.
AUTHOR. SIMOTIME TECHNOLOGIES.
*****************************************************************
* Copyright (C) 1987-2019 SimoTime Technologies. *
* *
* All rights reserved. Unpublished, all rights reserved under *
* copyright law and international treaty. Use of a copyright *
* notice is precautionary only and does not imply publication *
* or disclosure. *
* *
* Permission to use, copy, modify and distribute this software *
* for any commercial purpose requires a fee to be paid to *
* SimoTime Technologies. Once the fee is received by SimoTime *
* the latest version of the software will be delivered and a *
* license will be granted for use within an enterprise, *
* provided the SimoTime copyright notice appear on all copies *
* of the software. The SimoTime name or Logo may not be used *
* in any advertising or publicity pertaining to the use of the *
* software without the written permission of SimoTime *
* Technologies. *
* *
* Permission to use, copy and modify this software for any *
* non-commercial purpose and without fee is hereby granted, *
* provided the SimoTime copyright notice appear on all copies *
* of the software. The SimoTime name or Logo may not be used in *
* any advertising or publicity pertaining to the use of the *
* software without the written permission of SimoTime *
* Technologies. *
* *
* SimoTime Technologies makes no warranty or representations *
* about the suitability of the software for any purpose. It is *
* provided "AS IS" without any expressed or implied warranty, *
* including the implied warranties of merchantability, fitness *
* for a particular purpose and non-infringement. SimoTime *
* Technologies shall not be liable for any direct, indirect, *
* special or consequential damages resulting from the loss of *
* use, data or projects, whether in an action of contract or *
* tort, arising out of or in connection with the use or *
* performance of this software *
* *
* SimoTime Technologies *
* 15 Carnoustie Drive *
* Novato, CA 94949-5849 *
* 415.883.6565 *
* *
* RESTRICTED RIGHTS LEGEND *
* Use, duplication, or disclosure by the Government is subject *
* to restrictions as set forth in subparagraph (c)(1)(ii) of *
* the Rights in Technical Data and Computer Software clause at *
* DFARS 52.227-7013 or subparagraphs (c)(1) and (2) of *
* Commercial Computer Software - Restricted Rights at 48 *
* CFR 52.227-19, as applicable. Contact SimoTime Technologies, *
* 15 Carnoustie Drive, Novato, CA 94949-5849. *
* *
*****************************************************************
* This program is provided by SimoTime Technologies *
* Our e-mail address is: helpdesk@simotime.com *
* Also, visit our Web Site at http://www.simotime.com *
* *
*****************************************************************
*
*****************************************************************
* Source Member: SIMORA12.CBL
* Copy Files: PASSRA12.CPY
*****************************************************************
*
* SIMORA12 - Erase to End=Of-Field (EOF) after first space and
* then do a Right-Adjust, Zero-Fill for a 12 byte field.
*
* EXECUTION or CALLING PROTOCOL
* -----------------------------
* CALL 'SIMORA12' USING RA12-PASS-AREA.
*
*****************************************************************
*
* MAINTENANCE
* -----------
* 1997/02/27 Simmons, Created program.
* 1997/02/27 Simmons, No changes to date.
*
*****************************************************************
*
DATA DIVISION.
WORKING-STORAGE SECTION.
01 Z-X12 pic 9(3) value 0.
*****************************************************************
LINKAGE SECTION.
COPY PASSRA12.
*****************************************************************
PROCEDURE DIVISION using RA12-PASS-AREA.
add 16 to ZERO giving RA12-RESPOND
* The following INSPECT statement will erase to end-of-field
* any characters after the first space character.
inspect RA12-BUFFER
replacing CHARACTERS by ' ' after initial ' '
* The following IF logic is for performance. It quickly
* reduces the number of loops for the PERFORM logic.
if RA12-BUFFER(7:6) = SPACES
if RA12-BUFFER(4:3) = SPACES
move RA12-BUFFER(1:3) to RA12-BUFFER(10:3)
move all ZEROES to RA12-BUFFER(1:9)
else
move RA12-BUFFER(1:6) to RA12-BUFFER(7:6)
move all ZEROES to RA12-BUFFER(1:6)
end-if
else
if RA12-BUFFER(10:3) = SPACES
* The following three MOVE statements are used to
* avoid a potential problem with an overlapping MOVE.
move RA12-BUFFER(7:3) to RA12-BUFFER(10:3)
move RA12-BUFFER(4:3) to RA12-BUFFER(7:3)
move RA12-BUFFER(1:3) to RA12-BUFFER(4:3)
move all ZEROES to RA12-BUFFER(1:3)
end-if
end-if
perform until RA12-BUFFER(12:1) not = SPACE
if RA12-BUFFER(12:1) = SPACE
add 11 to ZERO giving Z-X12
perform 11 times
move RA12-BUFFER(Z-X12:1) to RA12-BUFFER
(Z-X12 + 1:1)
subtract 1 from Z-X12
end-perform
move ZERO to RA12-BUFFER(1:1)
end-if
end-perform
if RA12-BUFFER NUMERIC
move ZERO to RA12-RESPOND
else
add 8 to ZERO giving RA12-RESPOND
end-if
GOBACK.
*****************************************************************
* This example is provided by SimoTime Technologies *
* Our e-mail address is: helpdesk@simotime.com *
* Also, visit our Web Site at http://www.simotime.com *
*****************************************************************
COBOL Copy Files
This section describes the COBOL Copy Files that are used in this suite of COBOL programs.
Pass Area for Calling SIMORA12
The following (PASSRA12.cbl) is the COBOL source code for the demonstration program.
*****************************************************************
* Data Structure or Pass Area used for calling SIMORA12. *
*****************************************************************
* Copyright (C) 1987-2019 SimoTime Technologies *
* All Rights Reserved *
*****************************************************************
* Provided by SimoTime Technologies *
* Our e-mail address is: helpdesk@simotime.com *
* Also, visit our Web Site at http://www.simotime.com *
*****************************************************************
01 RA12-PASS-AREA.
05 RA12-REQUEST PIC X(8).
05 RA12-RESPOND PIC 9(4).
05 RA12-BUFFER.
10 RA12-NUMBER PIC 9(12).
*** PASSRA12 - End-of-Copy File - - - - - - - - - - - PASSRA12 *
*****************************************************************
*
Summary
This suite of programs provides an example of a routine that will Right Adjust (or Right Justify) a text string within a numeric field and fill the left-most or high-order bytes with zeroes. This document may be used to assist as a tutorial for new programmers or as a quick reference for experienced programmers.
In the world of programming there are many ways to solve a problem. This documentation and software were developed and tested on systems that are configured for a SIMOTIME environment based on the hardware, operating systems, user requirements and security requirements. Therefore, adjustments may be needed to execute the jobs and programs when transferred to a system of a different architecture or configuration.
SIMOTIME Services has experience in moving or sharing data or application processing across a variety of systems. For additional information about SIMOTIME Services or Technologies please contact us using the information in the Contact or Feedback section of this document.
Software Agreement and Disclaimer
Permission to use, copy, modify and distribute this software, documentation or training material for any purpose requires a fee to be paid to SimoTime Technologies. Once the fee is received by SimoTime the latest version of the software, documentation or training material will be delivered and a license will be granted for use within an enterprise, provided the SimoTime copyright notice appear on all copies of the software. The SimoTime name or Logo may not be used in any advertising or publicity pertaining to the use of the software without the written permission of SimoTime Technologies.
SimoTime Technologies makes no warranty or representations about the suitability of the software, documentation or learning material for any purpose. It is provided "AS IS" without any expressed or implied warranty, including the implied warranties of merchantability, fitness for a particular purpose and non-infringement. SimoTime Technologies shall not be liable for any direct, indirect, special or consequential damages resulting from the loss of use, data or projects, whether in an action of contract or tort, arising out of or in connection with the use or performance of this software, documentation or training material.
Downloads and Links
This section includes links to documents with additional information that are beyond the scope and purpose of this document. The first group of documents may be available from a local system or via an internet connection, the second group of documents will require an internet connection.
Note: A SimoTime License is required for the items to be made available on a local system or server.
Current Server or Internet Access
The following links may be to the current server or to the Internet.
Note: The latest versions of the SimoTime Documents and Program Suites are available on the Internet and may be accessed using the 
icon. If a user has a SimoTime Enterprise License the Documents and Program Suites may be available on a local server and accessed using the 
icon.
Explore How to Center, Left or Right Justify a text string within a field using a COBOL program. This suite of programs includes Job Scripts to create test data and execute the COBOL programs. The Job Scripts include JCL Members for an IBM Mainframe System, CMD Files for a Windows System and Bash Script Files for a Linux or UNIX System.
Explore the JCL Connection for more examples of JCL functionality with programming techniques and sample code.
Explore the COBOL Connection for more examples of COBOL programming techniques and sample code.
Explore An Enterprise System Model that describes and demonstrates how Applications that were running on a Mainframe System and non-relational data that was located on the Mainframe System were copied and deployed in a Microsoft Windows environment with Micro Focus Enterprise Server.
Explore The ASCII and EBCDIC Translation Tables. These tables are provided for individuals that need to better understand the bit structures and differences of the encoding formats.
Explore The File Status Return Codes that are used to interpret the results of accessing VSAM data sets and/or QSAM files.
Internet Access Required
The following links will require an internet connect.
This suite of programs and documentation is available to download for review and evaluation purposes. Other uses will require a SimoTime Software License. Link to an Evaluation zPAK Option that includes the program members, documentation and control files.
A good place to start is The SimoTime Home Page for access to white papers, program examples and product information. This link requires an Internet Connection
Explore The Micro Focus Web Site for more information about products (including Micro Focus COBOL) and services available from Micro Focus. This link requires an Internet Connection.
Explore the GnuCOBOL Technologies available from SourceForge. SourceForge is an Open Source community resource dedicated to helping open source projects be as successful as possible. GnuCOBOL (formerly OpenCOBOL) is a COBOL compiler with run time support. The compiler (cobc) translates COBOL source to executable using intermediate C, designated C compiler and linker. This link will require an Internet Connection.
Glossary of Terms
Explore the Glossary of Terms for a list of terms and definitions used in this suite of documents and white papers.
Contact or Feedback
This document was created and is maintained by SimoTime Technologies. If you have any questions, suggestions, comments or feedback please use the following contact information.
| 1. | Send an e-mail to our helpdesk. |
| 1.1. | helpdesk@simotime.com. |
| 2. | Our telephone numbers are as follows. |
| 2.1. | 1 415 763-9430 office-helpdesk |
| 2.2. | 1 415 827-7045 mobile |
We appreciate hearing from you.
Company Overview
SimoTime Technologies was founded in 1987 and is a privately owned company. We specialize in the creation and deployment of business applications using new or existing technologies and services. We have a team of individuals that understand the broad range of technologies being used in today's environments. Our customers include small businesses using Internet technologies to corporations using very large mainframe systems.
Quite often, to reach larger markets or provide a higher level of service to existing customers it requires the newer Internet technologies to work in a complementary manner with existing corporate mainframe systems. We specialize in preparing applications and the associated data that are currently residing on a single platform to be distributed across a variety of platforms.
Preparing the application programs will require the transfer of source members that will be compiled and deployed on the target platform. The data will need to be transferred between the systems and may need to be converted and validated at various stages within the process. SimoTime has the technology, services and experience to assist in the application and data management tasks involved with doing business in a multi-system environment.
Whether you want to use the Internet to expand into new market segments or as a delivery vehicle for existing business functions simply give us a call or check the web site at http://www.simotime.com
| Return-to-Top |
| Right Adjust, Zero Fill with Erase to End-of-Field Feature |
| Copyright © 1987-2025 SimoTime Technologies and Services All Rights Reserved |
| When technology complements business |
| http://www.simotime.com |