Command return code

When called as the main program, PERCON sets a command RC which indicates whether all PERCON statements have been executed without error and/or whether PERCON has terminated normally or abnormally. In the event of a warning or command abortion, the command RC is supplied with the relevant message code.

No command RC is set if PERCON is called as a subprogram.

The following events trigger a command RC:

1. normal termination: SC2=X'00' / SC1=X'00' / MC=C'CMD0001'

2. normal termination with warning: SC2=X'02' / SC1=X'00' / MC=C'PERxxxx'

3. abnormal termination after abortion of at least one conversion step:
   SC2=X'00' / SC1=X'01' / MC=C'PERxxxx'

   If there is no PER message (e.g. after syntactical errors in a mandatory sequence of statements, the following is set: MC=C'CMD0202'.

4. abnormal termination following an error that prevents dynamic linking of the prelinked PERCON module (and thus the PERCON run):
   SC2=X'00' / SC1=X'40' / MC=C'PERxxxx'

If more than one error situation occurs within the same PERCON run, the most serious error is reported. This implies, for instance, that the command RC assigned to a warning will not be output if a conversion step has been aborted. If several errors of the same weight occur, the first error is reported.

The maincode is determined by the event that has occurred rather than by the type of message output selected. It is therefore irrelevant for the maincode whether the message is actually output or suppressed in accordance with the settings in the MODIFY-PERCON-OPTIONS statement.

PERxxxx	SC2	SC1	Maincode	Meaning
0000 0029 0030 0070	-	-	-	No RC
0001	-	-	-	The program abortion is described in another PERCON message
	00	01	CMD0202	Other
0031	-	-	-	A warning is output by another PERCON message
	00	00	CMD0001	Other
0009 0012 0014 0016 0024 0040 0045 0051 0052 0054 0059 0065 0071 0084 0086 0092 0093 0094 0097 0109 0113 0117 0118	02	00	PERxxxx	Warnings
0021	02	00	PER0021	Response HN or SN received
	00	01	PER0021	Response HA or SA received
0022	00	01	PER0022	for output files for input files with TERMINATION = abnormal
	02	00	PER0022	for input files with TERMINATION = normal
0063	02	00	PER0063	Response I or S received
	00	01	PER0063	Response H received
0005 0006 0007 0008 0020 0025 0026 0027	-	-	-	with statement input via terminal
0028 0034 0043 0046 0047 0056 0062	00	01	PERxxxx	with mandatory sequence of statements
0010 0033 0049 0050 0055 0058 0067 0072	-	-	-	with statement input via terminal
0088 0089 0090 0091	02	00	PERxxxx	with fixed sequence of statements
0013 0066 0080 0087	-	-	-	with statement input via terminal
	02	00	PERxxxx	ISP statements, mandatory sequence of statements
	00	01	PERxxxx	SDF statements, mandatory sequence of statements
0002 0004 0011 0015 0017 0018 0019 0023 0032 0035 0036 0037 0038 0039 0041 0042 0044 0048 0053 0057 0060 0061 0064 0068 0069 0073 0074 0075 0076 0077 0078 0079 0081 0082 0083 0085 0096 0098 0099 0100 0101 0102 0103 0112 0114 0115 0116	00	01	PERxxxx	Conversion step aborted
0095 0104 0106 0107 0110 0111	00	64	PERxxxx	PERCON aborted
0105	00	64	CMD0205	PERCON aborted with TERM UNITS=STEP
0003	00	64	PER0003	Insufficient main memory during dynamic linking of prelinked module
	00	01	PER0003	Conversion step aborted due to insufficient main memory during PERCON run