Release notes for Model 204 version 7.5

These release notes list the enhancements and other changes contained in Model 204 version 7.5, which is still in development. Until the commercial release of the software, Rocket reserves the right to add to, remove, or change anything described herein.

Overview

These release notes contain installation and features information for the Rocket Model 204 version 7.5.0 release. Before beginning your installation, please read through this information about product installation and changes.

New in this release

This section summarizes the new features and enhancements for Model 204 version 7.5.0.

SOUL (User Language)

The significantly enhanced, object-oriented, version of User Language is now called SOUL. All existing User Language programs will continue to work under SOUL, so User Language can be considered to be a subset of SOUL, though the name User Language is now deprecated.

Feature	Operating System
Sirius object-oriented language extensions integration	z/VM, z/OS, z/VSE
ECF statements can pass up to 60 parameters	z/VM, z/OS, z/VSE

System Management

Feature	Operating System
Writing records to the SMF data set without an SVC installed	z/VM, z/OS, z/VSE

Performance

Feature	Operating System
GTBL can be stored above the bar	z/VM, z/OS, z/VSE

Operating system requirements

Requirements for Model 204 version 7.5.0 are still being determined.

Model 204 version 7.4.0 required the following operating system support:

For IBM z/OS: Version 1 Release 7 is sufficient for all new functionality except for the following features:
- Large (1 MB) page support requires Version 1 Release 9.
- Extended address volumes (EAV) requires Version 1 Release 12.
For IBM z/VM: Version 5 Release 4.0 or later
For IBM z/VSE:
- Version 5 Release 1 or
- Version 4 Release 3 or
- Version 4 Release 2.1 or
- Version 4 Release 2.0, with these program temporary fixes (PTFs) installed:
  - UD53436
  - UD53437
  - UD53438
  - UD53439

Hardware requirements

Requirements for Model 204 version 7.5.0 are still being determined.

Model 204 version 7.4.0 required the IBM z/890 or above processor, except for the following feature:

The large (1 MB) page support feature requires the IBM z10 or above processor.

Model 204 compatibility with operating systems

Content in this section is still to be determined.

Model 204 compatibility with Connect*

All supported versions of Connect* are compatible with Model 204 version 7.5.0. However, CLOB/BLOB support requires Connect* version 7.4.0 or higher. Use of Connect* versions earlier than version 7.4.0 to SELECT, UPDATE, or INSERT CLOB/BLOB data will fail and might produce unexpected application behavior and/or return an error. Connect* version 7.5.0 is compatible with versions of Model 204 that are earlier than version 7.5.0.

SOUL (User Language) enhancements

Much of the substantial new and enhanced functionality described in the following subsections is available as a result of the acquisition of Sirius Software. The functionality that is the subject of the initial subsection, "Object oriented programming," motivates the new name for User Language, SOUL, often thought of as Simple Objective User Language.

Object oriented programming

As of version 7.5 of Model 204 (and backward compatible with existing User Language applications), the SOUL language is equipped with Object-Oriented Programming (sometimes abbreviated O-O) capabilities comparable or superior to other contemporary object oriented languages. Formerly contained in the Janus SOAP User Language Interface, you can use Janus SOAP essentials as a set of entry points to the extensive SOUL O-O documentation.

Record capacity increase

in this version of Model 204, the record limit is increased from sixteen million records to forty-eight million records per file.

New SOUL statements

Non O-O enhancements in SOUL

External Call Facility (ECF)

EXTERNAL CALL statements can now pass more parameters. The maximum number of parameters that can be passed in an EXTERNAL CALL statement has been increased from 40 to 60. The maximum value setting for ECPSIZE is increased from 1310680 to 1966020 to accommodate the extra parameters.

REPEAT statement UNTIL option

The REPEAT statement now supports the UNTIL option. In previous releases, only REPEAT WHILE was supported.

A REPEAT UNTIL enters the loop body prior to checking the condition.

Example:

The following program results in output of '1':

BEGIN REPEAT WHILE %I EQ 0 %I = %I + 1 PRINT %I END

However, the following program results in an endless print loop:

BEGIN REPEAT UNTIL %I EQ 0 %I = %I + 1 PRINT %I END

New and changed classes and methods

New HttpRequest TranslateTable property

The TranslateTable HttpRequest property makes it possible to set the translate table to be used for EBCDIC to ASCII translation of data in an HttpRequest object.

New InvalidTranslateTable class

Objects of the InvalidTranslateTable exception class are thrown when a requested system translate table cannot be found. It is currently thrown only by the TranslateTable HttpRequest property.

New bit manipulation String functions

New bit manipulation functions BitClearString, BitCountString, BitFlipString, BitSetString, and BitValueString make it easier to manipulate the bits in a string.

New InvalidBitNumber class

Objects of the InvalidBitNumber exception class are thrown when an invalid bit number is requested by a bit manipulation function. It is currently thrown only by the BitClearString, BitFlipString, BitSetString, and BitValueString functions.

New option for AppendJournalData

The QT option has been added to the AppendJournalData method, to include QT type audit entries.

New and changed $functions

Former Sirius $functions

The $functions referred to by the link below are added to SOUL as a result of the acquisition of Sirius Software:

Sirius $functions

$SNDMAIL attachment ASCII translation

The $SNDMAIL function can now translate an attachment to ASCII before sending it. This translation is useful if the $SNDMAIL attachment is a CLOB (CHARACTER-LARGE-OBJECT) such as a text document.

The $SNDMAIL function now accepts an optional parameter after the name of the attached object. If this parameter is set to 'C' (or to a percent variable with the value 'C'), the object in the buffer is translated to ASCII before being attached to the email.

If this parameter is not specified, the object in the buffer is sent as a binary object.

In this example:

%RC = $SNDMAIL(%SUBJECT,,%BODY,%FROM,%TO,,,,'CLOB.TXT','C')

the CLOB.TXT attachment will be translated to ASCII before being attached to the email.

New products

These products are now available to Model 204 customers as separately purchased items as a result of the acquisition of Sirius Software.

File-related enhancements

Repeating field groups

[placeholder for long section to come from 7.2 rel notes]

Increased Table B record number capacity

Table B can now contain up to 48M possible record numbers. (The previous limit was 16M.)

Set FILEORG=X'200' at file creation time to allow for the increased record numbers.

Notes

The limit for BSIZE remains at 16M.
BSIZE * BRECPPG must be less than or equal to 48M (actually decimal 50,331,648 to be exact).
For example, if BSIZE = 16M, BRECPPG cannot be less than 3.
FILEORG=X'200' cannot be specified for files with hash key or sorted file organization.

System management enhancements

Writing records to the SMF data set

Having Model 204 write records to the SMF data set no longer requires the installation of an SVC.

Therefore, the SMFSVC parameter is no longer required and, if present, will be ignored and flagged with the following informational message:

M204.0204: PARAMETER SMFSVC OBSOLETE AND NOT RESET

However, the SMFLORN and SMFSLRN parameters must still be present in CCAIN if SMF records are required.

Performance enhancements

GTBL in above the bar storage

GTBL can now be placed into non-swappable server storage area above the bar. In order to store GTBL in ATB storage:

Increase the SERVNSSZ parameter by the GTBL size.
Set the second byte of the SERVNSA parameter to X’80’, so the value of SERVNSA is X'00800000'.

Note: The settings for each server table above the bar are independent of each other. So if both FTBL and GTBL are placed above the bar, then SERVNSA should be set to X'02800000'.

MQ/204 enhancements

Freeing MQ/204 subtasks and associated storage

The new MQDELDTP PST (pseudo subtask) checks for MQ/204 subtasks that are in a delayed detach state. MQDELDTP detaches MQ/204 subtasks that have finished their work and releases their associated storage areas.

Upward compatibility issues

INTERCOMM is no longer supported

The INTERCOMM interface supports the use of Teletype and 3270 terminals in line-at-a-time mode, using the Model 204 IODEV=29 thread type.

INTERCOMM is not supported in Model 204 version 7.5.

See the Rocket Model 204 Terminal User's Guide for a discussion of terminal interfaces.

New and changed commands

DEFINE FIELD new COMMA option

The COMMA option on the DEFINE FIELD command uses commas to separate displayed field attributes.

New and changed parameters

In addition to the following specific parameter changes, Model 204 parameter descriptions, for example as displayed by the VIEW command, are now in mixed case (unless translated to uppercase due to UPCASMSG.)

ECPSIZE max value increase

The maximum value setting for ECPSIZE has been increased from 1310680 to 1966020 to accommodate more External Call Facility parameters.

OUTPUT=DUMMY for IODEV=3 threads

IODEV=3 threads definitions now allow OUTPUT=DUMMY. When defining IODEV=3 threads, if output is not required, the OUTPUT parameter can be coded as OUTPUT=DUMMY.

For example:

IODEV=3,INPUT=IOD3IN1,OUTPUT=DUMMY

This means that no DD statement is required for the output data set, and in cases where many IODEV=3 threads are defined to simulate a large number of users, this enhancement will reduce the number of DD statements required by one half.

UPCASMSG new parameter

The UPCASMSG parameter can be used to translate messages issued by Model 204 to uppercase; otherwise (depending on the message being issued) they are displayed in mixed (upper and lower) case.

RETRVKEY parameter change

New in this release, if you specify a non-zero setting of RETRVKEY:

If you have set the X'01' or X'10' bits of the RETRVOPT parameter, you can use a forward retrieve PF key, in addition to the backward retrieve PF key specified by RETRVKEY.
Note: If either of these bits is set, the X'02' bit is strongly recommended as well.
The size of the allocated storage area, and hence the number and length of input lines available for retrieval, is specified by the value of the RETRVBUF parameter.

New and updated messages

M204.0204:
PARAMETER SMFSVC OBSOLETE AND NOT RESET
Explanation: Writing records to the SMF data set no longer requires the installation of an SVC. The SMFSVC parameter is therefore obsolete and cannot be reset.
System Manager Response: No response required.
Return Codes: I 0 0 AUDITMS

Messages M204.0332 and M204.0336 indicate problems with the CRAM interface. The visibility of these messages has been improved by:

writing the message to the operator and the JESLOG
writing the message as an ER line in CCAAUDIT
setting the return code to 80

M204.0332:
RC nn FROM CRFS OPEN
Explanation: The run has failed to initialize due to problems with the CRAM interface. The possible formats of this message are:

Format 1: RC nn FROM CRFS OPEN/PUT/GET

Format 2: ECB postcode FROM CRFS PUT/GET

Format 1 indicates that Model 204 module CRFS attempted to open channel, send a message down the channel, or receive a message from a channel. CRAM was unable to satisfy the request. The message states the return code and the operation attempted.
Format 2 indicates that Model 204 module CRFS received an unexpected post code from CRAM while attempting an I/O operation on a channel. The message states the post code and the operation attempted.

System Manager Response: Contact Technical Support and have the audit trail available.
Return Codes: C 80 80 AUDITER NOTERM OPR

M204.0336:
RC nn FROM CRIO OPEN
Explanation: The run has failed to initialize due to problems with the CRAM interface. The possible formats of this message are:

Format 1: RC nn FROM CRIO OPEN/PUT/GET

Format 2: ECB postcode FROM CRFS PUT/GET

Format 1 indicates that Model 204 module CRIO attempted to open a channel, send a message down a channel, or receive a message from a channel. CRAM was unable to satisfy the request. The message states the return code and the operation attempted. For example, the return code 16 indicates that the CRAM channel is already open.
Format 2 indicates that Model 204 module CRFS received an unexpected post code from CRAM while attempting an I/O operation on a channel. The message shows the post code and the operation attempted.

System Manager Response: Contact Technical Support and have the audit trail available.
Return Codes: C 80 80 AUDITER NOTERM OPR

M204.0434:
NJBUFF SET TO %C

Explanation: The NJBUFF parameter was set, either in CCAIN or in the parameters passed to Model 204 by the operating system, to an invalid value.

It is being reset to NSERVS + NSUBTKS + 1.

NJBUFF must be equal to:

one (1), or
value of the NSERVS parameter, plus the NSUBTKS parameter, plus 1

NJBUFF specifies the number of journal buffers allocated by Model 204 during initialization.
Response: Notify the system manager.
System Manager Response: Reset the NJBUFF parameter to a valid value and rerun Model 204.
Return Codes: I 0 0 AUDITAD

M204.0790:
FILE TOO BIG
Explanation: The total number of records possible in Table B exceeds 342 segments for files that do not have the FILEORG X'200' bit set and 1024 segments for files that have the FILEORG X'200' bit set. The number of potential record numbers per segment is 49,152. The number of possible segments in Table B is calculated by the following formula:

((BSIZE * BRECPPG) / 49,152)) + (1 if remainder not 0)

If the result exceeds 342 or 1024 respectively too many segments result and MODEL 204 rejects the CREATE command.
File Manager Response: Make the file smaller (by specifying a smaller BSIZE or smaller BRECPPG), or divide the file into smaller pieces and use the file group feature to process them as a single logical file.
Return Codes: C 0 4 AUDITER

M204.0797:
BSIZE*BRECPPG EXCEEDS MAXIMUM VALUE
Explanation: The product of BSIZE and BRECPPG must not exceed 16,777,216 for regular Model 204 files (which do not have the FILEORG X'200' bit set) and 50,331,648 for files that have the FILEORG X'200' bit set. These numbers specify the maximum number of records allowed in a single Model 204 file.

The CREATE or INCREASE command is rejected.
File Manager Response: Retry the command, specifying values for BSIZE and BRECPPG so that BSIZE*BRECPPG does not exceed the limit. Refer to the Rocket Model 204 File Manager's Guide for more information on file sizes.
Return Codes: C 0 4 AUDITER

M204.1052:
LOUTPB %C TO %C
Explanation: LOUTPB has been increased or decreased, to the value given in the message. With a full-screen terminal the value is 1.5 times the minimum for that model number, rounded up to a multiple of 8. A model 2 terminal results in a LOUTPB of 3200. A model 5 terminal results in a LOUTPB of 5664.

If NBKPG is greater than 0, the largest allowable value for LOUTPB is PAGESZ minus 40, so the value can be decreased for this reason.

User Response: No response is needed. This message is for information only.
Return Codes: I 0 0 AUDITAD

M204.1131:
CAN'T action
Explanation: The procedure action cannot be taken for one of the following reasons:

The procedure is in use by another user.
The procedure is not in the file.
The user does not have the correct privileges to change the procedure.
If a RENAME or ASSIGN has been attempted, the alias might already exist.

Response: Make sure that the procedure name is spelled correctly. If the named procedure is in use, retry the command when the procedure is no longer in use. Otherwise, arrange to place the procedure in the file or to obtain the privileges to change the procedure.
Return Codes: C 0 4 SUFFIX AUDITER

M204.1393:
CHUNK clause not of format "CHUNK chunkSize FOR chunkTarget"
Explanation: When a DEFINE FIELD command was entered, the syntax of the CHUNK clause was not in the format shown in this message.
File Manager Response: Correct the DEFINE FIELD command that has the incorrect CHUNK clause syntax.
Return Codes: C 0 4 AUDITER

M204.2126:
USER'S PUSHDOWN LIST OVERFLOWED
Explanation: The user's pushdown list is an internal stack for maintaining state information for user threads across internal Model 204 subroutines. The user pushdown list lives in each user's server. Its size requirement depends on the complexity of the command or User Language request.

This message is issued whenever Model 204 detects that pushdown list data has spilled into adjacent control structures. Because of potential corruption the user is restarted.
Response: Increase the size of the user pushdown list by using the LPDLST parameter of the UTABLE command. Notify your system manager.
System Manager Response: If this becomes a frequent occurrence, consider more permanent changes to LPDLST and SERVSIZE, since the pushdown list is a server component.
Return Codes: C 0 4 CANCEL

M204.2551:
{FPL|FCT PG1} IS INVALID FOR FILE: filename
Explanation: If the message says FPL, then the FPL (file parameter list) for the associated file is invalid. This could be the result of an incorrect DD, FILEDEF or DLBL statement.

If the message says FCT PG1, then the existence page array page is invalid.

File Manager Response: If the DD, FILEDEF or DLBL statement is correct and points to the correct data set, then the file must be restored from a backup.
Return Codes: C 0 4 AUDITER

M204.2836:
VALUE OF PARAMETER %C INVALID—RESET TO %C
Explanation: This is an informational message only.

A parameter was specified with an incorrect value. It has been reset to an internally calculated value that will accommodate other parameter settings. See the description of the parameter named to see what that calculation involves.
System Manager Response: The parameter has been reset. No response required.
Return Codes: I 0 0 AUDITMS

M204.2934:
FILEORG X''200'' not supported for hashed or sorted file organizations
Explanation: Hashed or sorted files must be 16M files. The CREATE FILE command is rejected.
File Manager Response: Remove the conflicting FILEORG parameter and reissue CREATE FILE.
Return Codes: E 0 4 AUDITMS