SIRLIBD record structure: Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
 
m (minor cleanup)
 
(One intermediate revision by one other user not shown)
Line 3: Line 3:
You've been warned.  ..  (Page built by JAL at the SIRIUS VM; file: FUNPGNEW SYSUT2) -->
You've been warned.  ..  (Page built by JAL at the SIRIUS VM; file: FUNPGNEW SYSUT2) -->
<!-- Page name: SIRLIBD record structure-->
<!-- Page name: SIRLIBD record structure-->
<var class="product">SirLib</var> stores a variety of change management information in the <var class="product">Model 204</var>
file <code>SIRLIBD</code>. This data is used in the <var class="product">SirLib</var> reporting system (Option 6 from the main
menu), and it may also be processed by user-provided reporting programs.


<var class="product">SirLib</var> stores a variety of change management information in the <var class="product">Model 204</var>
This table explains the record layout for <code>SIRLIBD</code>:
file SIRLIBD.
This data is used in the <var class="product">SirLib</var> reporting system (Option 6 from the main
menu) and may also be processed by user-provided reporting programs.
This appendix explains the record layout for SIRLIBD.


<table class="thJustBold">
<table class="thJustBold">
Line 18: Line 17:
<table class="thJustBold">
<table class="thJustBold">
<tr><th>SYS</th>
<tr><th>SYS</th>
<td>Rectype that specifies system defaults for <var class="product">SirLib</var>. There is only one record with this RECTYPE.</td></tr>
<td>Rectype that specifies system defaults for <var class="product">SirLib</var>. There is only one record with this Rectype.</td></tr>


<tr><th>FIL</th>
<tr><th>FIL</th>
<td>Rectype that specifies file defaults for <var class="product">SirLib</var> (missing fields on this record means use system default). One record of this RECTYPE for each registered file.</td></tr>
<td>Rectype that specifies file defaults for <var class="product">SirLib</var> (missing fields on this record means use system default). One record of this Rectype for each registered file.</td></tr>


<tr><th>PRO</th>
<tr><th>PRO</th>
Line 39: Line 38:


<tr><th>HST</th>
<tr><th>HST</th>
<td>Historical information kept if "Keep History" is specified in file or system defaults.</td></tr>
<td>Historical information kept if <code>Keep History</code> is specified in file or system defaults.</td></tr>
</table></td></tr>
</table></td></tr>


<tr><th>CHANGE</th>
<tr><th>CHANGE</th>
<td>Project name in CONTROL.<file>.</td></tr>
<td>Project name in <var>CONTROL.<i>file</i></var>.</td></tr>


<tr><th>FILE</th>
<tr><th>FILE</th>
Line 65: Line 64:


<tr><th>CONFIG</th>
<tr><th>CONFIG</th>
<td>Access to Re-Configuration.</td></tr>
<td>Access to Reconfiguration.</td></tr>


<tr><th>CUT</th>
<tr><th>CUT</th>
Line 71: Line 70:


<tr><th>RESEQ</th>
<tr><th>RESEQ</th>
<td>Access to Procedure Resequencing -- <var>Z</var> prefix command in <var class="product">SirPro</var>.</td></tr>
<td>Access to Procedure Resequencing (<var>Z</var> prefix command in <var class="product">SirPro</var>).</td></tr>


<tr><th>SECURE</th>
<tr><th>SECURE</th>
<td>Access to File-specific security.</td></tr>
<td>Access to file-specific security.</td></tr>
</table></td></tr>
</table></td></tr>


<tr><th>USER</th>
<tr><th>USER</th>
<td>User ID (from $ACCT).</td></tr>
<td>User ID (from <var>$Acct</var>).</td></tr>


<tr><th>WFILE</th>
<tr><th>WFILE</th>
<td>Work File. File that procedures were moved to via one of the managed update commands.</td></tr>
<td>Work file. File that procedures were moved to using one of the managed update commands.</td></tr>


<tr><th>ACTIVITY</th>
<tr><th>ACTIVITY</th>
<td>The managed update activity tracked on a history record (RECTYPE = HST).</td></tr>
<td>The managed update activity tracked on a history record (<code>RECTYPE=HST</code>).</td></tr>


<tr><th>ADMIN</th>
<tr><th>ADMIN</th>
<td>Administrator id specified on the SYS rectype.</td></tr>
<td>Administrator ID specified on the <var>SYS</var> rectype.</td></tr>


<tr><th>EXEMPT</th>
<tr><th>EXEMPT</th>
Line 93: Line 92:


<tr><th>DATE</th>
<tr><th>DATE</th>
<td>General date/time stamp, in <i>YYYYMMDDHHMM</i> form.</td></tr>
<td>General date/time stamp, in YYYYMMDDHHMM form.</td></tr>


<tr><th>HISTORY</th>
<tr><th>HISTORY</th>
<td>Single character flag indicating whether historical information should be kept for a file or system.
<td>Single character flag indicating whether historical information should be kept for a file or system.  
Contains either blank, Y (yes) or N (no). If RECTYPE=FIL, blank means refer to the setting on RECTYPE=SYS. If RECTYPE=SYS, blank means <i>keep history</i>.</td></tr>
<p>
Contains either blank, <code>Y</code> (yes), or <code>N</code> (no). If <code>RECTYPE=FIL</code>, blank means refer to the setting on <code>RECTYPE=SYS</code>. If <code>RECTYPE=SYS</code>, blank means "keep history."</p></td></tr>


<tr><th>OVERWRITE</th>
<tr><th>OVERWRITE</th>
<td>Single character flag indicating whether programmers are allowed to overwrite each other's update procedures (overwriting one's own update procedure is always allowed,
<td>Single-character flag indicating whether programmers are allowed to overwrite each other's update procedures. Overwriting one's own update procedure is always allowed, though a switch on the XCOMPARE screen will help prevent accidental overwrites.
though a switch on the XCOMPARE screen will help prevent accidental overwrites).
<p>
Contains either a blank, Y (yes) or N (no). If RECTYPE=FIL, blank means refer to the setting on RECTYPE=SYS. If RECTYPE=SYS, blank means <i>allow overwriting</i>.</td></tr>
Contains either a blank, <code>Y</code> (yes), or <code>N</code> (no). If <code>RECTYPE=FIL</code>, blank means refer to the setting on <code>RECTYPE=SYS</code>. If <code>RECTYPE=SYS</code>, blank means "allow overwriting."</p></td></tr>


<tr><th>PROC.LOCK</th>
<tr><th>PROC.LOCK</th>
<td>Single character flag indicating whether procedures should be locked against managed updates once a developer has checked out the procedure (checkout occurs when a "Q" command is executed against the procedure).
<td>Single character flag indicating whether procedures should be locked against managed updates once a developer has checked out the procedure. Checkout occurs when a <var>Q</var> command is executed against the procedure.
Contains a blank, Y (yes) or N (no). If RECTYPE=FIL, blank means refer to the setting on RECTYPE=SYS. If RECTYPE=SYS, blank means <i>don't</i> <i>lock procedures</i>.</td></tr>
<p>
Contains a blank, <code>Y</code> (yes), or <code>N</code> (no). If <code>RECTYPE=FIL</code>, blank means refer to the setting on <code>RECTYPE=SYS</code>. If <code>RECTYPE=SYS</code>, blank means <i>do not</i> lock procedures.</p></td></tr>


<tr><th>REQ.IDENT</th>
<tr><th>REQ.IDENT</th>
<td>Single character flag indicating whether an existing project identifier is required for generating update procedures.
<td>Single-character flag indicating whether an existing project identifier is required for generating update procedures.
Contains a blank, Y (yes) or N (no). If RECTYPE=FIL, blank means refer to the setting on RECTYPE=SYS. If RECTYPE=SYS, blank means <i>don't require identifiers</i>.</td></tr>
<p>
Contains a blank, <code>Y</code> (yes), or <code>N</code> (no). If <code>RECTYPE=FIL</code>, blank means refer to the setting on <code>RECTYPE=SYS</code>. If <code>RECTYPE=SYS</code>, blank means "don't require identifiers."</p></td></tr>


<tr><th>SECURE</th>
<tr><th>SECURE</th>
<td>Single character flag indicating whether the SECURITY settings defined in Option 4 of the <var class="product">SirLib</var> main screen should be enforced.
<td>Single-character flag indicating whether the SECURITY settings defined in Option 4 of the <var class="product">SirLib</var> main screen should be enforced.
Contains a blank, Y (yes) or N (no). If RECTYPE=FIL, blank means refer to the setting on RECTYPE=SYS. If RECTYPE=SYS, blank means <i>don't secure</i>.</td></tr>
<p>
Contains a blank, <code>Y</code> (yes), or <code>N</code> (no). If <code>RECTYPE=FIL</code>, blank means refer to the setting on <code>RECTYPE=SYS</code>. If <code>RECTYPE=SYS</code>, blank means "don't secure."</p></td></tr>


<tr><th>STAMP</th>
<tr><th>STAMP</th>
<td>Single character flag indicating whether managed procedures should be stamped with a single line comment for each change that has been applied.
<td>Single-character flag indicating whether managed procedures should be stamped with a single line comment for each change that has been applied.
If RECTYPE=FIL, blank means refer to the setting on RECTYPE=SYS. If RECTYPE=SYS, blank indicates that stamping <i>should be done</i>.</td></tr>
<p>
If <code>RECTYPE=FIL</code>, blank means refer to the setting on <code>RECTYPE=SYS</code>. If RECTYPE=SYS<code>RECTYPE=SYS</code>, blank indicates that stamping "should be done."</p></td></tr>


<tr><th>TEXT</th>
<tr><th>TEXT</th>
<td>Text for change comments and documentation on RECTYPE=DOC. Maximum length is 72 characters.</td></tr>
<td>Text for change comments and documentation on <code>RECTYPE=DOC</code>. Maximum length is 72 characters.</td></tr>


<tr><th>TIME</th>
<tr><th>TIME</th>
<td>Time stamp, in <i>HHMM</i> form.</td></tr>
<td>Time stamp, in HHMM form.</td></tr>


<tr><th>CUT.BASE</th>
<tr><th>CUT.BASE</th>
<td>Date/Time stamp from the most recent cutover of BASE procedures (RECTYPE=FIL), in <i>YYYYMMDDHHMM</i> form. When BASE procedures are cutover they are deleted.</td></tr>
<td>Date/Time stamp from the most recent cutover of Base procedures (<code>RECTYPE=FIL</code>), in YYYYMMDDHHMM form. When Base procedures are cutover, they are deleted.</td></tr>


<tr><th>CUT.CHANGE</th>
<tr><th>CUT.CHANGE</th>
<td>Date/Time stamp for the last time Update procedures were cutover (RECTYPE=FIL), in <i>YYYYMMDDHHMM</i> form. When Update procedures are cutover they are deleted.</td></tr>
<td>Date/time stamp for the last time Update procedures were cutover (<code>RECTYPE=FIL</code>), in YYYYMMDDHHMM form. When Update procedures are cutover, they are deleted.</td></tr>


<tr><th>CUT.IDENT</th>
<tr><th>CUT.IDENT</th>
<td>Date/Time stamp for the last time Project Identifiers were cutover (RECTYPE=FIL), in <i>YYYYMMDDHHMM</i> form. Project Identifiers are deleted from the "CONTROL.<i>filename</i>" file when they are cutover.</td></tr>
<td>Date/time stamp for the last time Project Identifiers were cutover (<code>RECTYPE=FIL</code>), in YYYYMMDDHHMM form. Project Identifiers are deleted from the <var>CONTROL.<i>filename</i></var> file when they are cutover.</td></tr>


<tr><th>CUT.STAMP</th>
<tr><th>CUT.STAMP</th>
<td>Date/Time stamp for the last time internal procedure stamps were cutover, that is, removed from procedures in the file (RECTYPE=FIL), in <i>YYYYMMDDHHMM</i> form.</td></tr>
<td>Date/time stamp for the last time internal procedure stamps were cutover, that is, removed from procedures in the file (<code>RECTYPE=FIL</code>), in YYYYMMDDHHMM form.</td></tr>


<tr><th>FIRST.CUT</th>
<tr><th>FIRST.CUT</th>
<td>Date/Time stamp for the first cutover performed on a file (RECTYPE=FIL), in <i>YYYYMMDDHHMM</i> form.</td></tr>
<td>Date/time stamp for the first cutover performed on a file (<code>RECTYPE=FIL</code>), in YYYYMMDDHHMM form.</td></tr>


<tr><th>LAST.CUT</th>
<tr><th>LAST.CUT</th>
<td>Date/Time stamp for the last time Cutover performed on a file (RECTYPE=FIL), in <i>YYYYMMDDHHMM</i> form.</td></tr>
<td>Date/time stamp for the last time Cutover performed on a file (<code>RECTYPE=FIL</code>), in YYYYMMDDHHMM form.</td></tr>


<tr><th>LAST.CONF</th>
<tr><th>LAST.CONF</th>
<td>Date/Time stamp for the last time a file was reconfigured (RECTYPE=FIL), in <i>YYYYMMDDHHMM</i> form.</td></tr>
<td>Date/time stamp for the last time a file was reconfigured (<code>RECTYPE=FIL</code>), in YYYYMMDDHHMM form.</td></tr>


<tr><th>UNLOCK</th>
<tr><th>UNLOCK</th>
<td>Date/Time stamp when a procedure was checked back in by an updating programmer (RECTYPE = PRC), in <i>YYYYMMDDHHMM</i> form.</td></tr>
<td>Date/Time stamp when a procedure was checked back in by an updating programmer (<code>RECTYPE=PRC</code>), in YYYYMMDDHHMM form.</td></tr>
</table>
</table>



Latest revision as of 00:35, 28 October 2015

SirLib stores a variety of change management information in the Model 204 file SIRLIBD. This data is used in the SirLib reporting system (Option 6 from the main menu), and it may also be processed by user-provided reporting programs.

This table explains the record layout for SIRLIBD:

Field Description
RECTYPE Field indicating record type, with following values:
SYS Rectype that specifies system defaults for SirLib. There is only one record with this Rectype.
FIL Rectype that specifies file defaults for SirLib (missing fields on this record means use system default). One record of this Rectype for each registered file.
PRO Unused.
USR Rectype for user security definition.
DOC Documentation associated with a project.
CHG Project Identifier record.
PRC Procedure record for procedures checked out by programmers.
HST Historical information kept if Keep History is specified in file or system defaults.
CHANGE Project name in CONTROL.file.
FILE Name of managed update file.
FFILE Name of update procedure file.
PROC Procedure name.
PROJECT Unused.
RESOURCE Name of a protected resource, as follows:
CHANGE Access to Change Definition.
CONFIG Access to Reconfiguration.
CUT Access to File Cutover.
RESEQ Access to Procedure Resequencing (Z prefix command in SirPro).
SECURE Access to file-specific security.
USER User ID (from $Acct).
WFILE Work file. File that procedures were moved to using one of the managed update commands.
ACTIVITY The managed update activity tracked on a history record (RECTYPE=HST).
ADMIN Administrator ID specified on the SYS rectype.
EXEMPT Prefix of procedures not to be stamped with internal comments on the status of the application of changes. Maximum length is forty characters.
DATE General date/time stamp, in YYYYMMDDHHMM form.
HISTORY Single character flag indicating whether historical information should be kept for a file or system.

Contains either blank, Y (yes), or N (no). If RECTYPE=FIL, blank means refer to the setting on RECTYPE=SYS. If RECTYPE=SYS, blank means "keep history."

OVERWRITE Single-character flag indicating whether programmers are allowed to overwrite each other's update procedures. Overwriting one's own update procedure is always allowed, though a switch on the XCOMPARE screen will help prevent accidental overwrites.

Contains either a blank, Y (yes), or N (no). If RECTYPE=FIL, blank means refer to the setting on RECTYPE=SYS. If RECTYPE=SYS, blank means "allow overwriting."

PROC.LOCK Single character flag indicating whether procedures should be locked against managed updates once a developer has checked out the procedure. Checkout occurs when a Q command is executed against the procedure.

Contains a blank, Y (yes), or N (no). If RECTYPE=FIL, blank means refer to the setting on RECTYPE=SYS. If RECTYPE=SYS, blank means do not lock procedures.

REQ.IDENT Single-character flag indicating whether an existing project identifier is required for generating update procedures.

Contains a blank, Y (yes), or N (no). If RECTYPE=FIL, blank means refer to the setting on RECTYPE=SYS. If RECTYPE=SYS, blank means "don't require identifiers."

SECURE Single-character flag indicating whether the SECURITY settings defined in Option 4 of the SirLib main screen should be enforced.

Contains a blank, Y (yes), or N (no). If RECTYPE=FIL, blank means refer to the setting on RECTYPE=SYS. If RECTYPE=SYS, blank means "don't secure."

STAMP Single-character flag indicating whether managed procedures should be stamped with a single line comment for each change that has been applied.

If RECTYPE=FIL, blank means refer to the setting on RECTYPE=SYS. If RECTYPE=SYSRECTYPE=SYS, blank indicates that stamping "should be done."

TEXT Text for change comments and documentation on RECTYPE=DOC. Maximum length is 72 characters.
TIME Time stamp, in HHMM form.
CUT.BASE Date/Time stamp from the most recent cutover of Base procedures (RECTYPE=FIL), in YYYYMMDDHHMM form. When Base procedures are cutover, they are deleted.
CUT.CHANGE Date/time stamp for the last time Update procedures were cutover (RECTYPE=FIL), in YYYYMMDDHHMM form. When Update procedures are cutover, they are deleted.
CUT.IDENT Date/time stamp for the last time Project Identifiers were cutover (RECTYPE=FIL), in YYYYMMDDHHMM form. Project Identifiers are deleted from the CONTROL.filename file when they are cutover.
CUT.STAMP Date/time stamp for the last time internal procedure stamps were cutover, that is, removed from procedures in the file (RECTYPE=FIL), in YYYYMMDDHHMM form.
FIRST.CUT Date/time stamp for the first cutover performed on a file (RECTYPE=FIL), in YYYYMMDDHHMM form.
LAST.CUT Date/time stamp for the last time Cutover performed on a file (RECTYPE=FIL), in YYYYMMDDHHMM form.
LAST.CONF Date/time stamp for the last time a file was reconfigured (RECTYPE=FIL), in YYYYMMDDHHMM form.
UNLOCK Date/Time stamp when a procedure was checked back in by an updating programmer (RECTYPE=PRC), in YYYYMMDDHHMM form.

See also