MVSFORUMS.com Forum Index MVSFORUMS.com
A Community of and for MVS Professionals
 
 FAQFAQ   SearchSearch   Quick Manuals   RegisterRegister 
 ProfileProfile   Log in to check your private messagesLog in to check your private messages   Log inLog in 

Emptying dataset using File-Aid.

 
Post new topic   Reply to topic   printer-friendly view    MVSFORUMS.com Forum Index -> Utilities
View previous topic :: View next topic  
Author Message
mf_user
Intermediate


Joined: 01 Jun 2003
Posts: 372
Topics: 105

PostPosted: Wed Feb 22, 2006 2:01 am    Post subject: Emptying dataset using File-Aid. Reply with quote

Hi,

I am using the following File-Aid code to empty a dataset with 1,00,000 records. The job is ending with a return code of 8.

Code:

//STEP01   EXEC PGM=FILEAID                         
//*                                                 
//SYSUDUMP DD  SYSOUT=*                             
//SYSPRINT DD  SYSOUT=*                             
//SYSLIST  DD  SYSOUT=*                             
//SYSTOTAL DD  SYSOUT=*                             
//*                                                 
//DD01     DD  DSN=TXXXX.JXXXXX.COPY.FLAT,DISP=SHR 
//DD01O    DD  DSN=TXXXX.JXXXXX.COPY.FLAT,DISP=SHR 
//*                                                 
//SYSIN    DD  *                                   
$$DD01 COPY S=0                                     
//*                                                 


Also, I tried the following File-Aid code and got the file emptied out but this job also ends with a return code of 8.

Code:

//STEP01   EXEC PGM=FILEAID                         
//*                                                 
//SYSUDUMP DD  SYSOUT=*                             
//SYSPRINT DD  SYSOUT=*                             
//SYSLIST  DD  SYSOUT=*                             
//SYSTOTAL DD  SYSOUT=*                             
//*                                                 
//DD01     DD  DSN=TXXXX.JXXXXX.COPY.FLAT,DISP=SHR 
//DD01O    DD  DSN=TXXXX.JXXXXX.COPY.FLAT,DISP=SHR 
//*                                                 
//SYSIN    DD  *                                   
$$DD01 CA RA                                     
//*                                                 


Would you please explain why I get RC=0008.

Thanks.
_________________
MF
==
Any training that does not include the emotions, mind and body is incomplete; knowledge fades without feeling.
==
Back to top
View user's profile Send private message Send e-mail
Ravi
Beginner


Joined: 27 Jun 2005
Posts: 88
Topics: 2

PostPosted: Wed Feb 22, 2006 3:13 am    Post subject: Reply with quote

File-aid returns 08 when no records are written/copied. If you have noticed, the File is empty after you run this step.

Hope this helps.


Rolling Eyes But my question is why do you want to empty a file like this. You can delete and create the file instead which is quite generally used.
Back to top
View user's profile Send private message
mf_user
Intermediate


Joined: 01 Jun 2003
Posts: 372
Topics: 105

PostPosted: Wed Feb 22, 2006 6:57 am    Post subject: Reply with quote

Ravi, we cannot ask the client to expalin why he wants it that way. We assumed that while creating an The file was certainly emptied out but I am just wondering why the emptying is tied with RC of 8.
_________________
MF
==
Any training that does not include the emotions, mind and body is incomplete; knowledge fades without feeling.
==
Back to top
View user's profile Send private message Send e-mail
kolusu
Site Admin
Site Admin


Joined: 26 Nov 2002
Posts: 12376
Topics: 75
Location: San Jose

PostPosted: Wed Feb 22, 2006 10:28 am    Post subject: Reply with quote

Quote:

We assumed that while creating an The file was certainly emptied out but I am just wondering why the emptying is tied with RC of 8.

mf_user,

That is because of the default option of how fileaid handles the empty files. and the option for empty file is stored in BTOPT18. In the below parm card, the last 2 bytes in bold is the empty dsn return code value. The default value is 08. You can override this value with a value from 0 to 99. However be careful with the other parms.

Quote:

//STEP0100 EXEC PGM=FILEAID,PARM='OPT=0250100606611121025000005882104'


Hope this helps....

Cheers

Kolusu
_________________
Kolusu
www.linkedin.com/in/kolusu
Back to top
View user's profile Send private message Send e-mail Visit poster's website
Ravi
Beginner


Joined: 27 Jun 2005
Posts: 88
Topics: 2

PostPosted: Thu Feb 23, 2006 12:15 am    Post subject: Reply with quote

Quote:

//STEP0100 EXEC PGM=FILEAID,PARM='OPT=0250100606611121025000005882104'


This OPT parameter made me to findout how to use it, what are the other parameters available and what all can be changed.. and so have pulled from Book Manager.

To all who are interested in check-out..

Code:
File-AID/MVS Installation Guide
 
 CHAP_4 Installation Option Variables
 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
 
 
    Table 4-1 through Table 4-6 list the variables in the Product Option
    table. You may change the values of these variables.
 
    Values are specified for these variables when you execute option 3:
    Product Options from the Install Manager main menu. The variables in the
    Product Option table are used to execute File-AID.
 
     Table  4-1. #CRITICAL Product Option Variable
 
 
    |---------|---------|-------------------|----------------------------|
    |Variable |Default  |Your Value         |Comments                    |
    |Name     |Value    |                   |                            |
    |---------|---------|-------------------|----------------------------|
    |FALIBDEF |Yes      |                   |Specify whether File-AID/MVS|
    |         |         |                   |can use the LIBDEF facility |
    |         |         |                   |to allocate the necessary   |
    |         |         |                   |datasets. Valid values are  |
    |         |         |                   |YES and NO.                 |
    |---------|---------|-------------------|----------------------------|
 
     Table  4-2. BATCH Product Option Variables
 
 
    |--------|--------|----------|------------------|---------------------------|
    |Variable|Displace|Default   |Your Value        |Comments                   |
    |Name    |ment    |Value     |                  |                           |
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT01 |00      |0250      |                  |RECORD PRINT DEFAULT. The  |
    |        |        |(F0F2F5F0)|                  |number of records that     |
    |        |        |          |                  |File-AID/MVS prints if no  |
    |        |        |          |                  |form of output control is  |
    |        |        |          |                  |placed on functions that   |
    |        |        |          |                  |cause printing on SYSLIST. |
    |        |        |          |                  |The value can be any number|
    |        |        |          |                  |from 0 through 9999. When  |
    |        |        |          |                  |all zeros (F0F0F0F0) are   |
    |        |        |          |                  |entered, all records in the|
    |        |        |          |                  |file are printed.          |
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT02 |04      |1 (F1)    |                  |FORM PRINT DEFAULT.        |
    |        |        |          |                  |Controls the kind of form  |
    |        |        |          |                  |that is printed.           |
    |        |        |          |                  |                           |
    |        |        |          |                  |0 (F0) Short. Prints a     |
    |        |        |          |                  |count field only at the top|
    |        |        |          |                  |and bottom of the page.    |
    |        |        |          |                  |                           |
    |        |        |          |                  |1 (F1) Long. Prints a count|
    |        |        |          |                  |field under each line.     |
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT03 |05      |0 (F0)    |                  |KEY PRINT. Determines      |
    |        |        |          |                  |whether File-AID/MVS prints|
    |        |        |          |                  |keys.                      |
    |        |        |          |                  |                           |
    |        |        |          |                  |0 (F0) Do not print keys.  |
    |        |        |          |                  |                           |
    |        |        |          |                  |1 (F1) Print keys.         |
    |        |        |          |                  |                           |
    |        |        |          |                  |For datasets where the key |
    |        |        |          |                  |is an integral part of the |
    |        |        |          |                  |record (keyed BDAM or      |
    |        |        |          |                  |unblocked ISAM), the key is|
    |        |        |          |                  |always printed regardless  |
    |        |        |          |                  |of this setting. Printing  |
    |        |        |          |                  |the keys can be changed    |
    |        |        |          |                  |dynamically with the KEY   |
    |        |        |          |                  |parameter.                 |
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT04 |06      |06 (F0F6) |                  |BATCH BUFFER SPACE.        |
    |        |        |          |                  |Controls the amount of     |
    |        |        |          |                  |memory assigned for buffer |
    |        |        |          |                  |space. The number of       |
    |        |        |          |                  |buffers assigned is        |
    |        |        |          |                  |calculated by multiplying  |
    |        |        |          |                  |this option number by 10   |
    |        |        |          |                  |kB, then dividing the total|
    |        |        |          |                  |by the block size of the   |
    |        |        |          |                  |dataset.                   |
    |        |        |          |                  |                           |
    |        |        |          |                  |The minimum allowed entry  |
    |        |        |          |                  |is 05 (50 kB) and the      |
    |        |        |          |                  |maximum is 99 (990 kB). The|
    |        |        |          |                  |default for this option is |
    |        |        |          |                  |6 which is multiplied by 10|
    |        |        |          |                  |kB = 60 kB. Accordingly,   |
    |        |        |          |                  |the default for            |
    |        |        |          |                  |File-AID/MVS/Batch buffers |
    |        |        |          |                  |is 60kB divided by the     |
    |        |        |          |                  |block size of the dataset. |
    |        |        |          |                  |                           |
    |        |        |          |                  |This space is assigned to  |
    |        |        |          |                  |each open dataset. This    |
    |        |        |          |                  |option can be overridden by|
    |        |        |          |                  |coding the BUFNO parameter |
    |        |        |          |                  |in the DCB entry on DD     |
    |        |        |          |                  |statements.                |
    |        |        |          |                  |                           |
    |        |        |          |                  |For VSAM datasets, this    |
    |        |        |          |                  |option times 10 kB becomes |
    |        |        |          |                  |the buffer space option. It|
    |        |        |          |                  |is then used to dynamically|
    |        |        |          |                  |compute the number of      |
    |        |        |          |                  |buffers to assign for VSAM |
    |        |        |          |                  |processing. In the case of |
    |        |        |          |                  |the USER function where    |
    |        |        |          |                  |more than two datasets are |
    |        |        |          |                  |open at the same time,     |
    |        |        |          |                  |memory may be a problem if |
    |        |        |          |                  |a region parameter is not  |
    |        |        |          |                  |entered on the EXEC or JOB |
    |        |        |          |                  |card.                      |
    |        |        |          |                  |                           |
    |        |        |          |                  |The minimum number of      |
    |        |        |          |                  |buffers File-AID/MVS allows|
    |        |        |          |                  |is five for MVS and three  |
    |        |        |          |                  |for non-MVS to allow       |
    |        |        |          |                  |support for chained        |
    |        |        |          |                  |scheduling.                |
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT05 |08      |06 (F0F6) |                  |TSO BUFFER SPACE. Controls |
    |        |        |          |                  |the amount of storage used |
    |        |        |          |                  |for buffers by each open   |
    |        |        |          |                  |dataset when File-AID/MVS  |
    |        |        |          |                  |is executed in a TSO       |
    |        |        |          |                  |environment. The           |
    |        |        |          |                  |description for Batch      |
    |        |        |          |                  |Buffer Space (displacement |
    |        |        |          |                  |06) also applies to this   |
    |        |        |          |                  |option.                    |
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT06 |0A      |6 (F6)    |                  |PRINTER SPACING. Controls  |
    |        |        |          |                  |the lines per inch (LPI) on|
    |        |        |          |                  |printed output.            |
    |        |        |          |                  |                           |
    |        |        |          |                  |6 (F6) This number converts|
    |        |        |          |                  |to 8 LPI for page printers.|
    |        |        |          |                  |                           |
    |        |        |          |                  |8 (F8) This number converts|
    |        |        |          |                  |to 12 LPI for page         |
    |        |        |          |                  |printers.                  |
    |        |        |          |                  |                           |
    |        |        |          |                  |This option can be changed |
    |        |        |          |                  |at run time with the LPI   |
    |        |        |          |                  |parameter.                 |
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT07 |0B      |1 (F1)    |                  |CHARACTER SET              |
    |        |        |          |                  |                           |
    |        |        |          |                  |0 (F0) Upper case only.    |
    |        |        |          |                  |                           |
    |        |        |          |                  |1 (F1) Upper case and lower|
    |        |        |          |                  |case.                      |
    |        |        |          |                  |                           |
    |        |        |          |                  |To change or add special   |
    |        |        |          |                  |characters, see the        |
    |        |        |          |                  |Character Translation Table|
    |        |        |          |                  |option at the end of this  |
    |        |        |          |                  |table.                     |
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT08 |0C      |1 (F1)    |                  |TSO PROMPTING. When        |
    |        |        |          |                  |executing File-AID/MVS     |
    |        |        |          |                  |under TSO, users can be    |
    |        |        |          |                  |prompted for input or not  |
    |        |        |          |                  |prompted.                  |
    |        |        |          |                  |                           |
    |        |        |          |                  |0 (F0) Do not prompt.      |
    |        |        |          |                  |                           |
    |        |        |          |                  |1 (F1) Prompt.             |
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT09 |0D      |1 (F1)    |                  |ABEND CONTROL. Specifies   |
    |        |        |          |                  |whether File-AID/MVS is to |
    |        |        |          |                  |abend if any I/O errors    |
    |        |        |          |                  |occur.                     |
    |        |        |          |                  |                           |
    |        |        |          |                  |0 (F0) No abends.          |
    |        |        |          |                  |                           |
    |        |        |          |                  |1 (F1) Abend if any I/O    |
    |        |        |          |                  |errors occur.              |
    |        |        |          |                  |                           |
    |        |        |          |                  |2 (F2) Abend for any I/O   |
    |        |        |          |                  |errors or any non-zero     |
    |        |        |          |                  |return codes.              |
    |        |        |          |                  |                           |
    |        |        |          |                  |3 (F3) Abend when the first|
    |        |        |          |                  |I/O error is encountered.  |
    |        |        |          |                  |                           |
    |        |        |          |                  |4 (F4) Abend when the      |
    |        |        |          |                  |number of data checks      |
    |        |        |          |                  |specified in the ERRS      |
    |        |        |          |                  |parameter is reached.      |
    |        |        |          |                  |                           |
    |        |        |          |                  |Values 1 and 2 do not      |
    |        |        |          |                  |produce a dump and continue|
    |        |        |          |                  |processing additional DDxx |
    |        |        |          |                  |datasets. Values 3 and 4   |
    |        |        |          |                  |produce a dump and         |
    |        |        |          |                  |terminate all processing.  |
    |        |        |          |                  |This option can be         |
    |        |        |          |                  |overridden with the ABEND  |
    |        |        |          |                  |parameter.                 |
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT10 |0E      |2 (F2)    |                  |DATE FORMATTING. Allows    |
    |        |        |          |                  |multiple formats for dates.|
    |        |        |          |                  |                           |
    |        |        |          |                  |0 (F0) MM-DD-CCYY          |
    |        |        |          |                  |                           |
    |        |        |          |                  |1 (F1) CCYY-MM-DD          |
    |        |        |          |                  |                           |
    |        |        |          |                  |2 (F2) DD-MM-CCYY          |
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT11 |0F      |1 (F1)    |                  |MONTH FORMATTING. Allows   |
    |        |        |          |                  |month to be a numeric or   |
    |        |        |          |                  |alpha value.               |
    |        |        |          |                  |                           |
    |        |        |          |                  |0 (F0) Numeric.            |
    |        |        |          |                  |                           |
    |        |        |          |                  |1 (F1) Three-character     |
    |        |        |          |                  |alphabetic.                |
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT12 |10      |025       |                  |I/O ERROR. Indicates the   |
    |        |        |(F0F2F5)  |                  |number of data checks      |
    |        |        |          |                  |File-AID/MVS is to allow   |
    |        |        |          |                  |per volume on tape datasets|
    |        |        |          |                  |before considering the     |
    |        |        |          |                  |dataset unusable. Any      |
    |        |        |          |                  |number from 0 (F0F0F0,     |
    |        |        |          |                  |which signifies unlimited  |
    |        |        |          |                  |errors) through 999        |
    |        |        |          |                  |(F9F9F9) can be specified. |
    |        |        |          |                  |This option can be changed |
    |        |        |          |                  |with the ERRS parameter.   |
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT13 |13      |0 (F0)    |                  |UPDATE OPTION. Controls    |
    |        |        |          |                  |updating of datasets that  |
    |        |        |          |                  |are not protected by your  |
    |        |        |          |                  |site security for the COPY,|
    |        |        |          |                  |DROP, REFORMAT, UPDATE, and|
    |        |        |          |                  |USER functions. Four       |
    |        |        |          |                  |settings may be entered:   |
    |        |        |          |                  |                           |
    |        |        |          |                  |0 (F0) Update any dataset. |
    |        |        |          |                  |                           |
    |        |        |          |                  |1 (F1) Disallow updating of|
    |        |        |          |                  |PDSs.                      |
    |        |        |          |                  |                           |
    |        |        |          |                  |2 (F2) Disallow updating of|
    |        |        |          |                  |any dataset.               |
    |        |        |          |                  |                           |
    |        |        |          |                  |3 (F3) N/A (Not applicable |
    |        |        |          |                  |to File-AID/MVS batch      |
    |        |        |          |                  |processing.)               |
    |        |        |          |                  |                           |
    |        |        |          |                  |4 (F4) Disallows           |
    |        |        |          |                  |destructive access to      |
    |        |        |          |                  |RECFM=U PDSs (load         |
    |        |        |          |                  |libraries).                |
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT14 |14      |0000      |                  |UPDATE ACCESS CODE. Limits |
    |        |        |(F0F0F0F0)|                  |updates to specific groups |
    |        |        |          |                  |of users. Any number from 0|
    |        |        |          |                  |(F0F0F0F0) through 4095    |
    |        |        |          |                  |(F4F0F9F5) is valid. This  |
    |        |        |          |                  |option is only valid if the|
    |        |        |          |                  |Update option is set to a  |
    |        |        |          |                  |value other than zero.     |
    |        |        |          |                  |File-AID/MVS is shipped    |
    |        |        |          |                  |with zeros in this field,  |
    |        |        |          |                  |which specifies NO access  |
    |        |        |          |                  |code. When a value is      |
    |        |        |          |                  |entered, it is converted   |
    |        |        |          |                  |from the specified decimal |
    |        |        |          |                  |value to its hexadecimal   |
    |        |        |          |                  |equivalent. For example, if|
    |        |        |          |                  |the number 2748 (F2F7F4F8) |
    |        |        |          |                  |is entered, the access code|
    |        |        |          |                  |to be entered at run time  |
    |        |        |          |                  |is ABC because hex'ABC' is |
    |        |        |          |                  |decimal 2748.              |
    |        |        |          |                  |                           |
    |        |        |          |                  |The access code is always a|
    |        |        |          |                  |three-character field. Even|
    |        |        |          |                  |if the number 0001 is      |
    |        |        |          |                  |entered for the option     |
    |        |        |          |                  |field, the access code that|
    |        |        |          |                  |must be entered is still   |
    |        |        |          |                  |001. This code need only be|
    |        |        |          |                  |entered once and is used to|
    |        |        |          |                  |override the Update option.|
    |        |        |          |                  |The CTL parameter is       |
    |        |        |          |                  |available to enter the     |
    |        |        |          |                  |access code and is coded as|
    |        |        |          |                  |follows:                   |
    |        |        |          |                  |                           |
    |        |        |          |                  |$$DDxxCTL=yyy              |
    |        |        |          |                  |                           |
    |        |        |          |                  |where yyy is the           |
    |        |        |          |                  |three-character access code|
    |        |        |          |                  |to be entered.             |
    |        |        |          |                  |                           |
    |        |        |          |                  |                           |
    |        |        |          |                  |CAUTION:                   |
    |        |        |          |                  |                           |
    |        |        |          |                  |This is the only place     |
    |        |        |          |                  |where this parameter is    |
    |        |        |          |                  |referenced. When           |
    |        |        |          |                  |File-AID/MVS reads this    |
    |        |        |          |                  |control card, it is not    |
    |        |        |          |                  |listed on SYSPRINT even if |
    |        |        |          |                  |the access code is wrong.  |
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT15 |18      |58 (F5F8) |                  |PRINT LINES AT 8LPI.       |
    |        |        |          |                  |Specifies the number of    |
    |        |        |          |                  |lines that are printed     |
    |        |        |          |                  |before overflow on SYSLIST |
    |        |        |          |                  |when PRINTER SPACING is F6 |
    |        |        |          |                  |(see displacement 0A).     |
    |        |        |          |                  |                           |
    |        |        |          |                  |Note: File-AID prints in   |
    |        |        |          |                  |sets of lines (DUMP is 4,  |
    |        |        |          |                  |PRINT is 2, LIST is 1) and |
    |        |        |          |                  |only recognizes overflow at|
    |        |        |          |                  |the end of a set.          |
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT16 |1A      |82 (F8F2) |                  |PRINT LINES AT 12LPI.      |
    |        |        |          |                  |Specifies the number of    |
    |        |        |          |                  |lines that are printed     |
    |        |        |          |                  |before overflow on SYSLIST |
    |        |        |          |                  |when displacement 0A is F8.|
    |        |        |          |                  |                           |
    |        |        |          |                  |Note: File-AID prints in   |
    |        |        |          |                  |sets of lines (DUMP is 4,  |
    |        |        |          |                  |PRINT is 2, LIST is 1) and |
    |        |        |          |                  |only recognizes overflow at|
    |        |        |          |                  |the end of a set.          |
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT17 |1C      |1 (F1)    |                  |USER FUNCTION. Specifies   |
    |        |        |          |                  |whether the USER function  |
    |        |        |          |                  |will be allowed. The value |
    |        |        |          |                  |0 (F0)indicates NO; F1     |
    |        |        |          |                  |indicates YES.             |
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT18 |1D      |08 (F0F8) |                  |NO RECORDS COPIED RETURN   |
    |        |        |          |                  |CODE. Specifies the return |
    |        |        |          |                  |code that File-AID is to   |
    |        |        |          |                  |issue when records are not |
    |        |        |          |                  |selected for copying to any|
    |        |        |          |                  |output dataset in a copy   |
    |        |        |          |                  |operation. The value 08    |
    |        |        |          |                  |reflects the current return|
    |        |        |          |                  |code issued. Any number    |
    |        |        |          |                  |from 00 (issue no return   |
    |        |        |          |                  |code) through 99 is valid. |
    |        |        |          |                  |File- AID always reflects  |
    |        |        |          |                  |the highest return code    |
    |        |        |          |                  |issued during an execution.|
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT19 |1F      |0 (F0)    |                  |MULTIPLE FILE PASS.        |
    |        |        |          |                  |Indicates if more than one |
    |        |        |          |                  |pass through a dataset is  |
    |        |        |          |                  |to be made.                |
    |        |        |          |                  |                           |
    |        |        |          |                  |0 (F0) Single pass.        |
    |        |        |          |                  |                           |
    |        |        |          |                  |1 (F1) Multiple passes.    |
    |        |        |          |                  |                           |
    |        |        |          |                  |Normal processing does not |
    |        |        |          |                  |reposition at the beginning|
    |        |        |          |                  |of a dataset for multiple  |
    |        |        |          |                  |functions. This option     |
    |        |        |          |                  |allows those multiple      |
    |        |        |          |                  |passes to be made. This    |
    |        |        |          |                  |option can also be changed |
    |        |        |          |                  |with the FORM parameter.   |
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT20 |20      |(00)      |                  |PAD CHARACTER. Sets a      |
    |        |        |          |                  |default For File-AID/MVS to|
    |        |        |          |                  |use to pad when the record |
    |        |        |          |                  |length changes during COPY |
    |        |        |          |                  |processing.                |
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT21 |21      |* (5C)    |                  |DYNAMIC ALLOCATION SYSOUT  |
    |        |        |          |                  |CLASS. Specifies the class |
    |        |        |          |                  |that File-AID/MVS assigns  |
    |        |        |          |                  |to the dynamically         |
    |        |        |          |                  |allocated SYSPRINT or      |
    |        |        |          |                  |SYSLIST dataset. Any valid |
    |        |        |          |                  |SYSOUT class characters are|
    |        |        |          |                  |allowed.                   |
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT22 |22      |M (D4)    |                  |PRINT CONTROL CHARACTERS.  |
    |        |        |          |                  |Allows File- AID/MVS to    |
    |        |        |          |                  |support either machine     |
    |        |        |          |                  |control characters M (D4)  |
    |        |        |          |                  |or ASA control characters A|
    |        |        |          |                  |(C1) on all printer        |
    |        |        |          |                  |datasets (SYSPRINT,        |
    |        |        |          |                  |SYSLIST, SYSTOTAL).        |
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT23 |23      |N (D5)    |                  |FORCE OUTPUT END OF VOLUME.|
    |        |        |          |                  |Allows File- AID/MVS to    |
    |        |        |          |                  |force end-of-volume (EOV)  |
    |        |        |          |                  |processing for the output  |
    |        |        |          |                  |tape dataset when the input|
    |        |        |          |                  |dataset reaches EOV. This  |
    |        |        |          |                  |option is only applicable  |
    |        |        |          |                  |for multi-volume tape      |
    |        |        |          |                  |datasets. Values are: N    |
    |        |        |          |                  |(D5) and Y (E8).           |
    |        |        |          |                  |                           |
    |        |        |          |                  |This option can be         |
    |        |        |          |                  |overridden at execution    |
    |        |        |          |                  |time with the FEOV         |
    |        |        |          |                  |parameter.                 |
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT24 |24      |0 (F0)    |                  |RDW PARAMETER EXPLANATION. |
    |        |        |          |                  |Parameters can be set to   |
    |        |        |          |                  |the following values:      |
    |        |        |          |                  |                           |
    |        |        |          |                  |0 (F0) Include and print   |
    |        |        |          |                  |RDW.                       |
    |        |        |          |                  |                           |
    |        |        |          |                  |1 (F1) Include and do not  |
    |        |        |          |                  |print the RDW.             |
    |        |        |          |                  |                           |
    |        |        |          |                  |2 (F2) Do not include and  |
    |        |        |          |                  |print RDW.                 |
    |        |        |          |                  |                           |
    |        |        |          |                  |3 (F3) Do not include and  |
    |        |        |          |                  |do not print the RDW.      |
    |        |        |          |                  |                           |
    |        |        |          |                  |This option can be         |
    |        |        |          |                  |overridden with the RDW    |
    |        |        |          |                  |parameter.                 |
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT25 |25      |08 (F0F8) |                  |OPEN ERROR RETURN CODE.    |
    |        |        |          |                  |Specifies the return code  |
    |        |        |          |                  |that File-AID/MVS is to    |
    |        |        |          |                  |issue when any type of open|
    |        |        |          |                  |error occurs. Any number   |
    |        |        |          |                  |from 00 (F0F0) through 99  |
    |        |        |          |                  |(F9F9) is valid.           |
    |        |        |          |                  |                           |
    |        |        |          |                  |                           |
    |        |        |          |                  |Note:   File-AID/MVS always|
    |        |        |          |                  |reflects the highest return|
    |        |        |          |                  |code issued during an      |
    |        |        |          |                  |execution.                 |
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT26 |27      |N (D5)    |                  |COPY EMPTY MEMBERS. Allows |
    |        |        |          |                  |the user to copy members   |
    |        |        |          |                  |without records. the       |
    |        |        |          |                  |default is N, do not copy  |
    |        |        |          |                  |empty members. Change to Y |
    |        |        |          |                  |(E8) to copy empty members.|
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT27 |28      |Y (E8)    |                  |CLOSE OUTPUT DATASETS AFTER|
    |        |        |          |                  |USER FUNCTION. Controls the|
    |        |        |          |                  |closing of output datasets |
    |        |        |          |                  |after consecutive USER     |
    |        |        |          |                  |functions.                 |
    |        |        |          |                  |                           |
    |        |        |          |                  |E8 (Y) Close output file(s)|
    |        |        |          |                  |when the $$DD changes (for |
    |        |        |          |                  |example, $$DD01, $$DD02).  |
    |        |        |          |                  |If a USER function uses    |
    |        |        |          |                  |$$DD numbers that are      |
    |        |        |          |                  |identical to the previous  |
    |        |        |          |                  |USER function, the output  |
    |        |        |          |                  |files are not closed. This |
    |        |        |          |                  |is the default setting.    |
    |        |        |          |                  |                           |
    |        |        |          |                  |D5 (N) Do not close output |
    |        |        |          |                  |files after each USER      |
    |        |        |          |                  |function. Close them only  |
    |        |        |          |                  |after the end of all       |
    |        |        |          |                  |consecutive USER functions.|
    |        |        |          |                  |                           |
    |        |        |          |                  |C1 (A) Always close output |
    |        |        |          |                  |files after each USER      |
    |        |        |          |                  |function.                  |
    |        |        |          |                  |                           |
    |        |        |          |                  |Note: For related          |
    |        |        |          |                  |information, see Appendix A|
    |        |        |          |                  |of the File-AID/Batch      |
    |        |        |          |                  |Reference Manual. It has 2 |
    |        |        |          |                  |examples (35 and 36) which |
    |        |        |          |                  |illustrate why you might   |
    |        |        |          |                  |choose one option over     |
    |        |        |          |                  |another:                   |
    |        |        |          |                  |                           |
    |        |        |          |                  |Example 35 illustrates     |
    |        |        |          |                  |splitting a single input   |
    |        |        |          |                  |dataset into multiple      |
    |        |        |          |                  |outputs.                   |
    |        |        |          |                  |                           |
    |        |        |          |                  |Example 36 illustrates     |
    |        |        |          |                  |splitting multiple input   |
    |        |        |          |                  |datasets into multiple     |
    |        |        |          |                  |outputs.                   |
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT28 |29      |N (D5)    |                  |SYSTEM-DETERMINED BLOCKSIZE|
    |        |        |          |                  |(BLKSIZE=0). If your       |
    |        |        |          |                  |operating system supports  |
    |        |        |          |                  |this installation option,  |
    |        |        |          |                  |it allows you to have your |
    |        |        |          |                  |system determine the       |
    |        |        |          |                  |blocksize of new output PS |
    |        |        |          |                  |and PO datasets allocated  |
    |        |        |          |                  |for File-AID/MVS/Batch if  |
    |        |        |          |                  |the RECFM is not undefined |
    |        |        |          |                  |(=U). The following        |
    |        |        |          |                  |settings are valid:        |
    |        |        |          |                  |                           |
    |        |        |          |                  |Y (E8) Enables your system |
    |        |        |          |                  |to determine the blocksize |
    |        |        |          |                  |when the blocksize is not  |
    |        |        |          |                  |coded or BLKSIZE=0 is      |
    |        |        |          |                  |coded.                     |
    |        |        |          |                  |                           |
    |        |        |          |                  |I (C9) Uses the IBM process|
    |        |        |          |                  |for determining blocksize. |
    |        |        |          |                  |File-AID allows the system |
    |        |        |          |                  |to determine the blocksize |
    |        |        |          |                  |when BLKSIZE=0 is coded.   |
    |        |        |          |                  |File-AID uses the blocksize|
    |        |        |          |                  |of the input dataset when a|
    |        |        |          |                  |blocksize is not coded.    |
    |        |        |          |                  |                           |
    |        |        |          |                  |If the output blocksize is |
    |        |        |          |                  |not coded, then the output |
    |        |        |          |                  |LRECL must be equal to the |
    |        |        |          |                  |input LRECL in order for   |
    |        |        |          |                  |File-AID to use the        |
    |        |        |          |                  |blocksize of the input     |
    |        |        |          |                  |dataset. If the LRECLs are |
    |        |        |          |                  |not equal, then File-AID   |
    |        |        |          |                  |assigns the output LRECL as|
    |        |        |          |                  |the output blocksize.      |
    |        |        |          |                  |                           |
    |        |        |          |                  |N (D5) Disables this       |
    |        |        |          |                  |support. File-AID uses the |
    |        |        |          |                  |blocksize of the input     |
    |        |        |          |                  |dataset when a blocksize is|
    |        |        |          |                  |not coded or BLKSIZE=0 is  |
    |        |        |          |                  |coded.                     |
    |        |        |          |                  |                           |
    |        |        |          |                  |Note: File-AID ignores the |
    |        |        |          |                  |setting of this install    |
    |        |        |          |                  |option unless you have     |
    |        |        |          |                  |IBM's Data Facility Product|
    |        |        |          |                  |(DFP) Version 3 Release 1  |
    |        |        |          |                  |or greater (for DASD), DFP |
    |        |        |          |                  |Version 3 Release 2 (for   |
    |        |        |          |                  |tape) or IBM's DFSMS       |
    |        |        |          |                  |installed.                 |
    |        |        |          |                  |                           |
    |        |        |          |                  |Modifying this option may  |
    |        |        |          |                  |change default allocations |
    |        |        |          |                  |of existing batch jobs.    |
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT29 |2A      |blank (40)|                  |FORMATTED PRINT COPYBOOK   |
    |        |        |          |                  |ALTERNATE LIBRARY. Allows  |
    |        |        |          |                  |the user to specify        |
    |        |        |          |                  |Librarian or Panvalet      |
    |        |        |          |                  |datasets for your formatted|
    |        |        |          |                  |print copybook library.    |
    |        |        |          |                  |                           |
    |        |        |          |                  |blank (40) PDSs and PDSEs  |
    |        |        |          |                  |only.                      |
    |        |        |          |                  |                           |
    |        |        |          |                  |L (D3) Librarian datasets. |
    |        |        |          |                  |                           |
    |        |        |          |                  |P (D7) Panvalet datasets.  |
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT30 |2B      |N (D5)    |                  |Reserved for future use.   |
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT31 |2C      |N (D5)    |                  |FORMATTED PRINT JAPANESE   |
    |        |        |          |                  |SUPPORT.  Enables  Japanese|
    |        |        |          |                  |double byte character set  |
    |        |        |          |                  |(DBCS) character support   |
    |        |        |          |                  |for formatted print.       |
    |        |        |          |                  |                           |
    |        |        |          |                  |N (D5) Standard print      |
    |        |        |          |                  |characters.                |
    |        |        |          |                  |                           |
    |        |        |          |                  |Y (E8) Japanese DBCS print |
    |        |        |          |                  |characters.                |
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT32 |2D      |N (D5)    |                  |PRINT RECORD INFORMATION.  |
    |        |        |          |                  |The default is N (D5), do  |
    |        |        |          |                  |not include record disk    |
    |        |        |          |                  |addresses when printing    |
    |        |        |          |                  |user data files. Change to |
    |        |        |          |                  |Y (E8) to include record   |
    |        |        |          |                  |disk addresses when        |
    |        |        |          |                  |printing user data files.  |
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT33 |2E      |F (C6)    |                  |PROCESSING DIRECTION.      |
    |        |        |          |                  |Allows you to switch the   |
    |        |        |          |                  |processing direction. The  |
    |        |        |          |                  |default is F (C6) forward. |
    |        |        |          |                  |Change to B (C2) for       |
    |        |        |          |                  |backwards.                 |
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT34 |2F      |N (D5)    |                  |PROCESS IN JCL FORMAT. The |
    |        |        |          |                  |default is N (D5), do not  |
    |        |        |          |                  |process in JCL format.     |
    |        |        |          |                  |Change to Y (E8) to process|
    |        |        |          |                  |records in JCL format.     |
    |        |        |          |                  |                           |
    |        |        |          |                  |This option can be         |
    |        |        |          |                  |overridden at execution    |
    |        |        |          |                  |time with the FORM=JCL     |
    |        |        |          |                  |parameter.                 |
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT35 |30      |Y (E8)    |                  |PDS REPLACE LIKE MEMBERS.  |
    |        |        |          |                  |The default is Y (E8),     |
    |        |        |          |                  |replaces like-named members|
    |        |        |          |                  |in a PDS. Change to N (D5),|
    |        |        |          |                  |do not replace like-named  |
    |        |        |          |                  |members.                   |
    |        |        |          |                  |                           |
    |        |        |          |                  |This option can be         |
    |        |        |          |                  |overridden at execution    |
    |        |        |          |                  |time with the RLM          |
    |        |        |          |                  |parameter.                 |
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT36 |31      |N (D5)    |                  |COPY ENTIRE MEMBER. The    |
    |        |        |          |                  |default is N (D5), do not  |
    |        |        |          |                  |copy the entire member;    |
    |        |        |          |                  |copy only the selected     |
    |        |        |          |                  |records. Change to Y (E8)  |
    |        |        |          |                  |to copy the entire member  |
    |        |        |          |                  |when any of the records in |
    |        |        |          |                  |the member match the       |
    |        |        |          |                  |selection criteria.        |
    |        |        |          |                  |                           |
    |        |        |          |                  |This option can be         |
    |        |        |          |                  |overridden at execution    |
    |        |        |          |                  |time with the MEM          |
    |        |        |          |                  |parameter.                 |
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT37 |32      |N (D5)    |                  |MAINTAIN PDS STATISTICS.   |
    |        |        |          |                  |                           |
    |        |        |          |                  |N (D5) Do not maintain PDS |
    |        |        |          |                  |statistics.                |
    |        |        |          |                  |                           |
    |        |        |          |                  |Y (E8) Maintain PDS        |
    |        |        |          |                  |statistics.                |
    |        |        |          |                  |                           |
    |        |        |          |                  |A (C1) Maintain PDS        |
    |        |        |          |                  |statistics, and add when   |
    |        |        |          |                  |they previously did not    |
    |        |        |          |                  |exist.                     |
    |        |        |          |                  |                           |
    |        |        |          |                  |This option can be         |
    |        |        |          |                  |overridden at execution    |
    |        |        |          |                  |time with the PDSSTAT      |
    |        |        |          |                  |parameter.                 |
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT38 |33      |blank (40)|                  |BATCH VTOC EXCP PROCESSING.|
    |        |        |          |                  |                           |
    |        |        |          |                  |E7 (X) Use EXCP (execute   |
    |        |        |          |                  |channel program) I/O       |
    |        |        |          |                  |processing to read DASD    |
    |        |        |          |                  |VTOCs.                     |
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT39 |34      |0 (00)    |                  |UNEQUAL COMPARE RETURN     |
    |        |        |          |                  |CODE. Specify the return   |
    |        |        |          |                  |code to display when the   |
    |        |        |          |                  |Compare function (option   |
    |        |        |          |                  |10) finds any differences  |
    |        |        |          |                  |in the data that you       |
    |        |        |          |                  |specify to compare from the|
    |        |        |          |                  |old to the new dataset.    |
    |        |        |          |                  |Valid entries are          |
    |        |        |          |                  |hexadecimal values 00      |
    |        |        |          |                  |through FF.                |
    |--------|--------|----------|------------------|---------------------------|
    |        |        |          |                  |The options preceding this |
    |        |        |          |                  |message can be modified at |
    |        |        |          |                  |execution time. See "Modify|
    |        |        |          |                  |Batch Options at Execution"|
    |        |        |          |                  |on page 49. The options    |
    |        |        |          |                  |following this message     |
    |        |        |          |                  |cannot be modified at      |
    |        |        |          |                  |execution time.            |
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT40 |36      |nine      |                  |CHARACTER TRANSLATION TABLE|
    |BTOPT41 |        |blanks    |                  |EXTENSION. Used for SYSLIST|
    |BTOPT42 |        |(40)      |                  |character translation. All |
    |BTOPT43 |        |          |                  |9 positions are set to     |
    |BTOPT44 |        |          |                  |blanks,                    |
    |BTOPT45 |        |          |                  |(404040404040404040). You  |
    |BTOPT46 |        |          |                  |may enter up to nine       |
    |BTOPT47 |        |          |                  |additional special         |
    |BTOPT48 |        |          |                  |characters.                |
    |--------|--------|----------|------------------|---------------------------|
    |BTOPT49 |58      |DFLT      |                  |CHARACTER SET TABLE. When  |
    |        |        |(C4C6D3E3)|                  |the value of this option is|
    |        |        |          |                  |appended to "FAXT" it      |
    |        |        |          |                  |becomes the name of a      |
    |        |        |          |                  |character set translation  |
    |        |        |          |                  |table in the File- AID/MVS |
    |        |        |          |                  |load library. This table is|
    |        |        |          |                  |used to determine if a     |
    |        |        |          |                  |character is displayable or|
    |        |        |          |                  |printable. The default is  |
    |        |        |          |                  |DFLT (American English).   |
    |        |        |          |                  |Values that are currently  |
    |        |        |          |                  |valid are:                 |
    |        |        |          |                  |                           |
    |        |        |          |                  |BELG (C2C5D3C7) Belgian.   |
    |        |        |          |                  |                           |
    |        |        |          |                  |CNBL (C3D5C2D3) Canadian   |
    |        |        |          |                  |Bilingual.                 |
    |        |        |          |                  |                           |
    |        |        |          |                  |CNFR (C3D5C6D9) Canadian   |
    |        |        |          |                  |French.                    |
    |        |        |          |                  |                           |
    |        |        |          |                  |CYRL (C3E8D9D3) Cyrillic.  |
    |        |        |          |                  |                           |
    |        |        |          |                  |DFLT (C4C6D3E3) American   |
    |        |        |          |                  |English.                   |
    |        |        |          |                  |                           |
    |        |        |          |                  |FREN (C6D9C5D5) French.    |
    |        |        |          |                  |                           |
    |        |        |          |                  |GREK (C7D9C5D2) Greek.     |
    |        |        |          |                  |                           |
    |        |        |          |                  |HEB (C8C5C240) Hebrew.     |
    |        |        |          |                  |                           |
    |        |        |          |                  |HEBN (C8C5C2D5) Hebrew new,|
    |        |        |          |                  |post Aleph.                |
    |        |        |          |                  |                           |
    |        |        |          |                  |HEBO (C8C5C2D6) Hebrew old,|
    |        |        |          |                  |post Aleph.                |
    |        |        |          |                  |                           |
    |        |        |          |                  |ICLN (C9C3D3D5) Icelandic. |
    |        |        |          |                  |                           |
    |        |        |          |                  |KANA (D2C1D5C1) Japanese.  |
    |        |        |          |                  |                           |
    |        |        |          |                  |LATN (D3C1E3D5) Roece      |
    |        |        |          |                  |Latin.                     |
    |        |        |          |                  |                           |
    |        |        |          |                  |PGSE (D7C7E2C5) Portuguese.|
    |        |        |          |                  |                           |
    |        |        |          |                  |SPAN (E2D7C1D5) Spanish.   |
    |        |        |          |                  |                           |
    |        |        |          |                  |SWED (E2E6C5C4) Swedish.   |
    |        |        |          |                  |                           |
    |        |        |          |                  |SWFG (E2E6C6C7)            |
    |        |        |          |                  |Swiss-French and Swiss-    |
    |        |        |          |                  |German.                    |
    |        |        |          |                  |                           |
    |        |        |          |                  |THAI (E3C8C1C9) Thai.      |
    |--------|--------|----------|------------------|---------------------------|
    |        |        |          |                  |TURK (E3E4D9D2) Turkish.   |
    |        |        |          |                  |                           |
    |        |        |          |                  |YUGO (E8E4C7D6) Yugoslav.  |
    |        |        |          |                  |                           |
    |        |        |          |                  |3277 (F3F2F7F7) Model 3277 |
    |        |        |          |                  |display terminals.         |
    |        |        |          |                  |                           |
    |        |        |          |                  |For information on code    |
    |        |        |          |                  |pages, refer to the IBM    |
    |        |        |          |                  |manual, 3270 Information   |
    |        |        |          |                  |Display Systems Character  |
    |        |        |          |                  |Set Reference.             |
    |--------|--------|----------|------------------|---------------------------|
 
  CHAP_4.1 Modify Batch Options at Execution
 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
 
    The OPT parameter in the PARM field is used to override or change batch
    options with displacements of 00 through 35. File-AID processes the option
    fields as one contiguous data field, so all options to the left of the
    option being changed must be specified as well. The data entered in the
    OPT parameter overlays the installation option area from left to right
Back to top
View user's profile Send private message
mf_user
Intermediate


Joined: 01 Jun 2003
Posts: 372
Topics: 105

PostPosted: Thu Feb 23, 2006 3:48 am    Post subject: Reply with quote

Thanks to Ravi for finding out the details of OPT usage.
Surprised
Well....well........this is really great piece of information. But as Kolusu rightly points out this is not suggested for the application programmers I believe. By the way, why anybody would want to change the OPTs? Does it improve performance? Am I correct if I interpret it this way - the OPT18 works as set maxcc=0 with IDCAMS irrespective of original return code !?!? Rolling Eyes
_________________
MF
==
Any training that does not include the emotions, mind and body is incomplete; knowledge fades without feeling.
==
Back to top
View user's profile Send private message Send e-mail
mf_user
Intermediate


Joined: 01 Jun 2003
Posts: 372
Topics: 105

PostPosted: Thu Feb 23, 2006 3:51 am    Post subject: Reply with quote

Ravi, may I ask the you to provide the link to the book from where you've got this info. Smile Question
_________________
MF
==
Any training that does not include the emotions, mind and body is incomplete; knowledge fades without feeling.
==
Back to top
View user's profile Send private message Send e-mail
kolusu
Site Admin
Site Admin


Joined: 26 Nov 2002
Posts: 12376
Topics: 75
Location: San Jose

PostPosted: Thu Feb 23, 2006 5:41 am    Post subject: Reply with quote

Quote:

Ravi, may I ask the you to provide the link to the book from where you've got this info

mf_user,

Look up the File-AID/MVS Installation Guide . Ravi's post already shows that.
_________________
Kolusu
www.linkedin.com/in/kolusu
Back to top
View user's profile Send private message Send e-mail Visit poster's website
Display posts from previous:   
Post new topic   Reply to topic   printer-friendly view    MVSFORUMS.com Forum Index -> Utilities All times are GMT - 5 Hours
Page 1 of 1

 
Jump to:  
You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot vote in polls in this forum


MVSFORUMS
Powered by phpBB © 2001, 2005 phpBB Group