OPAL GSTablegen Software Changes - Version 530 ->

Attributes have been added to reflect recent MCPs.

PD and SYSTEM PD New Attributes:

  SYSADMIN, PDSYSADMIN

  MPGRAN(MPGSDIRECTORY), PDMPGRAN(<title>,MPGSDIRECTORY)

  DOCUMENTTYPE, PDDOCUMENTTYPE, PERMITTEDACTIONS, PDPERMITTEDACTIONS

  TIMESTAMPDAY (marked for deimplementation since 4.0, use TSDAY)

  SYSADPRIV,SYSADPRIVTRANSPARENT,WHENHOLDTIME,HOLDQTIME,SCHEDTOD,
  WORKLOADGROUP,D1WORKLOADGROUP,WLGCODEFILELOCK,WLGWLMLOCK,
  REQCPURATEBIAS,LOGICALREADS,LOGICALWRITES,PHYSICALREADS,
  PHYSICALWRITES,IODELAYTIME,SCHEDULEDTIME,CPUVISITS,STATUSSTRING,
  DMSREADS,DMSWRITES,DMSTRSTATES,DMSDELAYTIME,WLMSUSPENDTOD,
  METEREDRPMSECS,METEREDIPBSECS,METEREDOPBSECS,NORMPROCTIME

  CPURATEBIAS,BASEPRIORITY,FINEPRIORITY,TOTALPRIORITY,SCHEDPRIOR

 TARGETPROCESSOR,ACTUALPROCESSOR,SYSADPRIV,SYSADPRIVTRANSPARENT,
 NORMPROCTIME,MAXASDS,WHENHOLDTIME,LOGICALREADS,LOGICALWRITES,
 PHYSICALREADS,PHYSICALWRITES,DMSREADS,DMSWRITES,DMSTRSTATES,
 WLMSUSPENDTIME,SYSADPRIV,SYSADPRIVTRANSPARENT,IDENTITY,MCSNAME,MPID
 D1WORKLOADGROUP,WORKLOADGROUP

Move DFHIMAGE and DFHBINARY onto the GETSTATUS RowAddressWords Mask Bit.

Several new attributes have been added to the DEFINE context; these are COMPRESSED (if the OPAL script source has been compressed in the SCHEDULE file) and COMPRESSLENGTH (the length of the compressed source in bytes).

The LOGNO, CURRENBTLOG and RECORDNO attributes have been added to the METALOG context allowing an individual log entry to be identified by its record number in a particular log file.

Add mnemonics for the Log attribute LOGTYPE.

A new attribute, VALIDEMAIL, is available to SUPERVISOR allowing the caller to validate an email address passed in as a parameter. VALIDEMAIL is implemented using an entrypoint in the MAILLIB library. An address without a hostname (i.e. no '@' part) is accepted and VALIDEMAIL will automatically use the default domain set from MAILLIB. Please see HELP ATTR VALIDEMAIL for more information.

Delete the mnemonic LOGCONTEXT and add the Mnemonic ADVSCHED (for advanced scheduling) to the LICENCEDAYS attribute.

This change supports the cleanup of the values returned by the LABEL and EIOSTATUS attributes in SUPERVISOR's PER context, described in OPAL DNote 540.72.

Update the PDSUBKINDLIST semantics.

The FAMILYTIMESECONDS attribute has been added to the PER context; this returns the time-of-day in seconds that the base pack of a disk family or CD-ROM was created.

The PRODUCT attribute in the METALOG context now has additional values:

 SITE and FLEX

The following attributes have been implemented in the AFTER context to support Advanced Scheduling:

  ONCUSTOM
  CUSTOMOFFSET
  HOLIDAYOFFSET
  HOLIDAYPLUSOFFSET

These attributes allow information to be returned about the ON CUSTOM ON HOLIDAY and EXCEPT HOLIDAYS modifiers for the AFTER command as described in SUPERVISOR DNote 541.38.

New attributes have also been added to the SYSTEM context allowing all valid SUPERVISOR-assigned workdays, holidays and custom days to be returned as individual list of julian dates delimited by commas. The attributes are:

  HOLIDAYLIST         e.g.    "123,2011001,2011002,2012153"
  CUSTOMDAYLIST
  WORKDAYLIST

Note that dates specified by the HOLIDAYS command may not have been assigned with a year: in such cases, HOLIDAYLIST will return the julian day offset only for the current year as can be seen by the value 123 instead of 2011123.

On MCP 54.1, the attributes DBJOBNUMBER, DBMNIXNUMBER and DBSTACKNO in the DATABASE context always returned zero. These attributes were retrieving information from a now invalid serial word in the SUMLOG entry. Any OPAL scripts using these attributes must be recompiled on MCP 54.1 using a version of SUPERVISOR with this change.

Similarly, the ACTOR class of attributes (such as ACTOR_JOBNO) in the FILEOPEN context now returns correct values for job and mix numbers though current attributes still work on MCP 54.1.

This changes documents the addition of the NEXTACTIVITYDAY attribute to the AFTER context. This attribute returns the date of the next scheduled occurrence of the selected AF activity allowing for holiday exceptions etc.

The DLIPFILES attribute has been deimplemented as it has not been available since MCP 48.1.

In the Prints context the Jobnumber attribute would return Mixnumber and the Mixnumber attribute JobNumber.

The METALOG context has been extended to include a new logging subcontext called FLEX.

Add CHUNKED and LOCATION attributes for HTTP.

Several new attributes for SUPERVISOR's WHEN context allowing information to be returned about the current status of all jobs invoked by the WFL function for any WHEN slot. The attributes are:

   WFLS             Number of active WFL jobs
   WFLSACTIVE       Job number list of active WFL jobs
   WFLIDS           Identity list of active WFL jobs (returns '*' for
                    jobs with no identity)

Add ACTIONS to JOBQUEUE Context.

Add Custom Context attribute template GETSTRINGATT.

New attributes have been added for the MAIL context:

  ATTACHFILE, INCLUDEFILE and ZIPFILE

These return information about the MCP files that have been attached or included in a MAILLIB email request.

Add Custom Context attributes TOSTRING,HELP,LASTERRORTEXT,ATTLIST, FUNCTIONNAME,INTERFACENAME,LIBPARAMETER.

Adds ONTRIGGER,TRIGGER and WHERE attributes.

This change supports the new MAILLIB context within SUPERVISOR allowing the capture of MAILLIB email transactions, errors and events by WHENs that use the MAIL context. For more information, please refer to SUPERVISOR DNote 540.94.

The LOGBINARY and DFHBINARY attributes have been added to the LOG and PD contexts respectively. Please refer to OPAL DNote 540.52 for more information about their use.

The ASAP subcontext has been removed from the METALOG context.

A new SO option, NOTTLOGGING (option 28), has been added. Please see SUPERVISOR DNote 540.81 for more information.

Add HTTP attributes STATUSCODE,REASONPHRASE,URL_FRAGMENT,

                    ASYNCREQUEST,READYSTATE,RESPONSELENGTH,
                    RESPONSETIME for XMLHttpRequest.

The SUBKINDLIST attribute has been added to the PD context for FLEX and SUPERVISOR. See HELP ATTR SUBKINDLIST for more information.

Remove unimplemented PD Actions.

Add the FILEHANDLE attribute to the JOB Context. FILEHANDLE for a WFLOPEN, WFLIN, WFLOUT or WFLCLOSE Job Message returns a Handle for the Station with LSN, which is assigned to the File identified by the FRSN. It is used with OPAL Transmit function to write to a Remote File.

The syntax for the OPAL Transmit Function is now,

  $DCResult:=Transmit(<filehandle>,<text>)

A new MYSELF variant, PROGRESS, is now available. This attribute is available for use by the ON PROGRESS statement in the OPAL compiler and indicates the percentage progress of am Opal MZIP or GZIP operation. Please see OPAL DNote 540.37 for more details.

The AFTER context attribute ONLOADSCHED returns true for entries scheduled with AFTER LOAD.

Add LSN and FRSN to Job.

Add Remote JobMsgTypes.

The HolOnly attribute is true if an entry was scheduled using ON HOLIDAYS

This change adds the NICKNAMES attribute to the SYSTEM ML context and MYSELF(TRANSNO) returns the last MAILLIB transaction number for the specified SUPERVISOR WHEN slot.

Add TO_UNZIP to PD Context Actions.

MYSELF(CALLDEPTH) returns the current depth of call DOs

Ex. ODTS C2 performs CALL DO "C1" ODTS C1 performs CALL DO "CL" ODTS CL performs #L:=Myself(CallDepth) #L with have the value 2

Add the HTTP ACCESSCODE session attribute.

Added the TO_EXTRACT Action for the PD Context.

A new boolean attribute called MZIPLASTERROR,a synonym for TTLASTERROR, is available to checks the results of ZIP, UNZIP, ZIPFILE and UNZIPFILE function/method calls.

Add BODYEXTERNAL to indicate that the BODY has been stored in an external File. Add UPGRADE, SEC_WEBSOCKET_ORIGIN, SEC_WEBSOCKET_PROTOCOL, SEC_WEB_SOCKET_KEY1, SEC_WEBSOCKET_KEY2 and SEC_WEBSOCKET_LOCATION Header Attributes.

Add RANGE and ACCEPT-RANGES HTTP Header Attributes.

The MYSELF attribute will no longer list inappropriate mnemonics in the Help Att command. The Myself and WHENID attributes are now synonyms, both now return string and integer data. The INPUTPARAM and COMMAND attributes have been added to the WHEN

 context

The Age attribute now takes an optional mnemonic parameter INDAYS the default if no parameter is passed and INSECONDS. The time between the current time and the timestamp time is calculated and returned in units of whole days or seconds. If the timestamp of a file was 1 second before midnight yesterday and Age was interrogated at 1 second after midnight then it would return 0 days or 2 seconds.

The SECCLASS attribute returned the wrong mnemonics. S1 was returned for S0, S2 for S1 and Minimal for S2

The CPM attribute, when passed a processor number, returns ON or OFF if that processor is in-use by the MCP. However, CPM would only handle a maximum of 8 CPUs and returned incorrect values because of an indexing issue. These problems are now resolved.

Also, the EVENTTYPE attribute in the WHEN context now has improved explanatory semantics.

The new Flex attribute Age returns the the number of days since the date of the file TIMESTAMP.

New Supervisor Attributes WHENID(INPUTPARAM) returns the text of any parameter passed to this Slot. EX. TT DO MIX_ODTS 1234,5678 WHENID (INPUTPARAM) would return '1234,5678'

TT EV PD_SITU DO PD_ODTS (*)=AX= IN "XYZ.CON" WHENID(INPUTPARAM) would return '(*)=AX= IN "XYZ.CON"'

MYSELF(FIRST) Returns the value of the TERM FIRST setting

New Flex Attribute

INPUTPARAM Returns the text of the most recent command.

Ex REP HEAD INPUTPARAM Followed by FILES =BoB= ON DEV:FL Would return FILES =BoB= ON DEV:FL followed by the list of files

Does what it says in the heading.

Add PDF to MIMETYPE function.

Several new TAPEDB attributes, LOGICALREEL and LOGICALLIST, have been implemented. Their usage is described in more detail in TAPELIBUPDATER DNote 530.12.

Added new attributes METERPRIORTIME,METERCURRENTTIME,METERMONTHTIME, METERECENTTIME returning the same data as their ...TS equivalents but expressed in seconds since 1/1/1970.

The time can be extracted from these attributes using an expression like METERPRIORTIME MOD (24*3600). The Julian date with an expression like NEWDATE(1970001,METERPRIORTIME DIV(24*3600))

Also added METERIMAGEPRIOROVER, METERIMAGECURRENTOVER and INCMETEROVERUTIL.

New Attributes: TZABBREVIATION (SYSTEM) Returns STRING in the form of an Identifier

                 TIMEZONE is a synonym for this Attribute 

TZNAME (SYSTEM) Returns STRING in the form of an Identifier Semantics : Full time zone name.

TZNUMBER (SYSTEM) Returns INTEGER Semantics : The predefined time zone number or zero.

TZOFFSETDIRECTION (SYSTEM) Returns INTEGER Semantics : Indicates if the time zone offset is added to or subtracted from the universal time to get local time. 0 indicates no time zone, 1 indicates add the offset and 2 indicates subtract the offset.

TZOFFSETHOURS (SYSTEM) Returns INTEGER Semantics : Hours offset (0 through 24).

TZOFFSETMINUTES (SYSTEM) Returns INTEGER Semantics : Minutes offset (0 through 59).

TZOFFSETTIME (SYSTEM) Returns INTEGER Semantics : Total offset time in minutes as a positive or negative integer.

PINGSECURITYERROR and PINGCOMMANDERROR mnemonics have been added to the PINGRESULT attribute.

New Attributes VSVER,VSORIGINALREFS and ORIGINALREFS. See HELP ATT for details.

Two new attributes, LOGNAME and LOGSUBSTRING, have been added to the LOG context. These attributes allow both standard form and substandard form names to be extracted from a LOG record where a suitable OPAL context does not exist. PLease refer to OPAL DNote 531.24 for further information.

A new reference attribute called PDKEY is now available and permits retrieval of file information via the PD context from any OPAL script. Please refer to SUPERVISOR DNote 531.45 for more information.

SERIALNO attributes in relevant contexts have been changed to LINK to the TAPEDB context. A new attribute group, SERIALVL, allows linkage to the VL context.

Two new attributes, SLOTMEMORY and VARIABLES, have been added to the WHEN context.

This change supports a new SUPERVISOR context called STATIONS. The STATIONS context allows access to all active and inactive MCP datacom station information similar to that returned by the SYSTEM/DCSTATUS utility. These MCP datacom tables include both pseudo and physical stations and, where a station is in-use by a MCS, additional session information is provided.

Please refer to SUPERVISOR DNote 531.40 for more information; see HELP ATTR =:STATIONS for a list of available attributes.

This change supports another new SUPERVISOR context called SESSIONS. The SESSIONS context allows access to information about all MCP job and MCS sessions currently active in the system. This feature is made possible due to the new SESSIONS ODT command now available in MCP 53.1 and later versions of 52.1

Please refer to SUPERVISOR DNote 531.35 for additional information; see HELP ATTR =:SESSIONS for a list of available attributes.

The NETWORKFILE and NETWORKLIBRARY attributes now provide links to the PD and SL contexts respectively.

This change supports a new SUPERVISOR context called SHOWOPEN. The SHOWOPEN context allow the retrieval of information about all open, in-use files on a specified disk family and includes both temporary and permanent files. If the family is the DL JOBS family, then Job File information will be returned. Please refer to SUPERVISOR DNote 531.33 for more information and refer to HELP ATTR =:SHOWOPEN for a list of available attributes.

Investigation of ACTION Attribute.

Julian dates have two formats in Opal. The OLD YYDDD (now YYYDDD) and for newer attributes YYYYDDD. The old form of Julian date returns the year - 1900. So 2009 is returned as 109. Many old julian attribute names end in DAY and have an equivalent attribute returning a 4 digit year ending in TSDAY. The format is now described in the header line of HELP ATT.

EX.

  ACCESSDAY (PD) Returns INTEGER as Julian Day -1900 YYYDDD
  ACCESSTSDAY (PD) Returns INTEGER as Julian Day YYYYDDD

LMLICENSEKEYV gives the Key Status of a file on a Unisys conditioned tape or CD. Only valid for :FAST on conditioned Lib/Maint MT/CD media.

Add new SEARCHTYPE mnemonics in PD context for FILE <dir> <unit>:FAST

Make TAPEFEET (8@#12[FN]) instead of an attribute function, so it now no longer needs compiler support for a multi-bit mask.

Move GSHEADERSIZE Defines in FlexForm to INCLUDE/META.

A new SUPERVISOR context, METALOG, has been implemented. This context allows retrieval of log entries from Metalogic's internal log files maintained by SUPERVISOR, MAILLIB and TRIM. Unlike SUMLOG-based scripts, METALOG Opals can only be used with the EVAL command as no event support is available. Please refer to SUPERVISOR DNote 531.21 for more information and HELP ATTR =:METALOG will show the small subset of supported attributes.

Some new attributes for the DEFINE context have been added to provide additional information concerning the method used to compile an individual DEFINE. These attributes include REFERENCE, REMOTESOURCE, SOURCEKIND and SOURCEHOSTNAME.

This changes supports a new SUPERVISOR context called SL. The SL context allow the retrieval of information for all MCP SL functions from OPAL scripts using EVAL. Please refer to SUPERVISOR Dnote 531.20 for more information and refer to HELP ATTR =:SL for a list of attributes currently available.

Internal change: the current mechanism for attribute mnemonic handling has been changed because array limits had been exceeded (GSMNEMINFO). There are no issues with existing compiled code.

New When context attributes TIMEDPER,SOURCE,WAITSECS, NEWODTS and NEWSITU.

Add <JDAY> to indicate Julian Date, and <TSTIME> to indicate a TimeStamp time.

A new SUPERVISOR context called DEFINE has been implemented. This context allows Opal scripts to interrogate SUPERVISOR's OPAL program dictionary with the EVAL command and return useful information for any DEFINE in that dictionary. Please refer to SUPERVISOR DNote 531.15 for more information.

The attribute SMTPFAMILY has been added to the SYSTEM MAIL subset used to return information about the family used by MAILLIB to hold *SMTP files. The MAIL attribute NICKNAMES is now also available.

PRINTABLE returns whether the file can be used in a WFL PRINT statement

The mnemonic TTSORTCANCEL has been added to the TTLASTERROR attribute to capture TT function EVALs that use an invalid SORT clause.

The Mnemonic LOGGING (47) is now valid with the SO attribute.

This change supports a new OPAL attribute called GETDISKFARMSERIAL available only to FLEX. Please refer to OPAL DNote 530.30 for more information.

The UPLOAD and DOWNLOAD attributes are used to request a file transfer in a Scripting Environment. In OPAL they return the same value as TITLE.

The CONTENT, HEADER and ROWMAP attributes represent PD context information available in a a Scripting Environment. In OPAL they return the same value as TITLE.

The FI attribute represents MIX context information in a Scripting environment. In OPAL it returns the same value as MIXNUMBER.

A small subset of attributes is available supporting the Opal PING function described by Opal DNote 530.25. These attributes return information about the PING itself and its success or failure.

Use of the PDGUARDED attribute gave an error: FLEXLIB:RECOMPILE NEEDED (INVALID ATTRIBUTE) in REPORT. This problem has been corrected.

A subset of attributes called SYSTEM MAIL is now available; these attributes provide run-time and configuration information for the Metalogic MAILLIB library. Only available to SUPERVISOR, information may be obtained by the command:

  HELP ATTR =:SYSTEM MAIL

A new attribute called DFHIMAGE has been implemented for both FLEX and SUPERVISOR (PD context). DFHIMAGE returns an image of the Disk File Header of the selected file. By default, this is returned in JavaScript array format with each header word in hexadecimal format delimited by commas. For example:

 [128,'3F3F0A4003E8','801000000000','000000000052',...]

The first entity in the array indicates the size of the header in words.

Two new parameters have been added to the Myself attribute. DEPTH - Call depth where environment data is saved. Ex Call DO of a MSG ODTS passing a parameter increments this depth. MAXDEPTH - The limit for DEPTH. If Depth exceeds this limit an ODTS will be aborted.

The semantics for the DUCHEKRBOARD attribute have been updated to show that the Fixed, Inuse and Temp flags now return integer values of 1 or 0 instead of the literals 'true' and 'false'.

The DUCHECKERBOARD attribute now includes a FiLEKIND mnemonic for each file area that is mapped and appears after the file title. For example, the CSV variant would appear as:

[Start sector,Sector count,Title,Filekind,Fixed,InUse,Temp]

 4028,227796,41,*DEV/PI0017M2007301A,PROMBURNERDATA,FALSE,FALSE,FALSE

Similarly, the web JS format includes the FILEKIND as a quoted string.

A new OPAL attribute called DUCHECKERBOARD is now available which can provide a detailed file analysis of a specified sector range on a selected disk family index. Please see SUPERVISOR DNote 530.54 for more information and HELP ATTR DUCHECKERBOARD.

It is now possible for OPAL attribute semantics to show double-quotes in their descriptions instead of the single version, allowing attribute usage to be correctly described.

Semantics for the TTLASTERROR attribute have been corrected.

Various attributes belonging to the Supervisor VDBS context have been modified due to recent changes documented on the Unisys support web site regarding the DMINQ function (from the DMALGOL Programming Reference manual). A small attribute set whose names start with 'AVERAGE' have now been replaced by 'SUM' to reflect the change in meaning of the values returned and have had their semantics updated.

Further, several VDBS attributes such as TOTALPRIEXTENDWAITTIME and NUMPREVIOWAITS will now return corrected values and will not appear as synonyms for other attributes when interrogated with the HELP command. Several new VDBS attributes - TOTALPRIAUDIIOS, SUMPREVIOBUFFERS and TOTALSECAUDITIOS - are now available on DMSII 52.1.

The DAY attribute has been added to the AFTER context; this is a subset of the DAYTYPE attribute but with the TODAYONLY mnemonic absent. This means that DAY will return, if processing a record from today's schedule, the current day of the week instead a TODAY value.

The SUPERVISOR attribute MINUTE in the AFTER context has been renamed to AFMINUTE to avoid conflict with the SYSTEM attribute of the same name.

The ORDINALWEEKDAY attribute has been added to the AFTER context - this attribute returns TRUE if the specified activity was assigned with an 'ON nTH <WeekDay>' modifier such as 'ON 1ST FRIDAY' or 'ON 5th SUNDAY'. To complement the MONTHMASK and WEEKMASK attributes, DAYMASK has been implemented to represent activities that have been assigned with modifiers such as 'ON MONDAY','ON 1st TUESDAY-THURSDAY'.

This change supports new mnemonics for the POSTSCRIPTS attribute in the AFTER context as described in SUPERVISOR DNote 530.26 . New AFTER attributes, JOBNUMBER and WITHIN, have also been added.

The list of parameter mnemonics that may be used with the SO attribute has been updated to match that available to SUPERVISOR's SO command.

TADS/PDTADS atts are valid for code files and return true if $TADS was set during their compile. TADS is not valid in :FLAT searches.

DOLLARVERSION in the PD Context is a string containing the $VERSION info.

The FLEX LF and LF:ATT reports now show if $TADS is set (before the $VERSION information.) They now use the DOLLARVERSION and PDSEG0VERSION attributes respectively.

A new SUPERVISOR context called AFTER has been implemented. This allows the user to interrogate the SUPERVISOR AFTER schedule using OPAL programs that are processed with the EVAL command. Please see SUPERVISOR DNote 530.22 for more information.

The CHARGECODE attribute in the WHEN context will now return a correct value instead of a corrupted string. The LSN attribute has been added to this context.

The attribute TIMELASTEVAL has been added to the WHEN context and a parameter of the same name is now available to the MYSELF attribute. TIMELASTEVAL is used to denote the elapsed time since an event-driven WHEN was triggered or, if the EVAL count is zero, this is the time the WHEN was started.

This change supports the new WHEN context for SUPERVISOR; please see SUPERVISOR DNote 530.13 for more information.

Add Links to some PRINTS attributes.

The DTD, NAMESPACE and MIMETYPE attributes which were only valid in the HTTP Context, are now SYSTEM attributes and so valid in all Contexts.

A Supervisor Eval will now accept a range for the Evals and Entries.

Myself(DoStart) returns the start of the range for Entries. Myself(EvalStart) returns the start of the range of Evals. Myself(DOSkipped) returns the number of entries skipped due to the DoStart limit. Myself(EvalSkipped) returns the number of evals skipped due to the EvalStart limit.

Opal attributes are now qualified on MCP 5.3