Using Mainframe Access (MFA) - Micro Focus
Using Mainframe Access (MFA) - Micro Focus Using Mainframe Access (MFA) - Micro Focus
Using Mainframe Access (MFA) from a COBOL program 56 A length error, at a record level, has been detected 57 A general security error has been detected 58 A hash code mismatch has been detected 59 The remote execution failed 60 The JES spool file is not an output file 61 The JES spool file is not a held output file 100 Syntax error in call 125 Too many concurrent users are active 139 The record length was too large 218 The DCB is not supported. This is usually caused by trying to use RECFM=U 219 The mainframe load libraries are not APF authorized 220-241 Various SAF security return codes 242 The component in use has not been activated on the mainframe 243 Unable to write the specified file to the workstation 244 Unable to read the specified file from the workstation 245 The catalog search detected an error 246 The catalog search did not yield any results 247 The /F MFENDDRV* statement was not in FHREDIR.CFG 248 The /F MFLSCDRV* statement was not in FHREDIR.CFG 249 The file FHREDIR.CFG could not be located 250 A communications failure occurred 251 The file did not have a positive length 252 An invalid mask was given 253 The local access mask was not specified 254 The local access mode was not set 255 Invalid function was requested Importing Data You can import individual members, or a collection of members defined by a filter, from the JES spool, a partitioned dataset or source code control system or you can import entire QSAM, VSAM datasets, IMS databases or DB/2 tables with automatic data conversion to the appropriate Micro Focus format. You may optionally specify a control file containing one or more commands and allow MFDAS to run them as a batch. To do this, place the commands in a control file of any name, without the preceding MFDAS parameter, then run MFDAS with the parameter @filename, where filename is the name of the control file. Text or binary transfers are possible. Use the BINARY or TEXT operand to override the default transfer type for the type. The default transfer type for PDS, Librarian, Panvalet, Endevor, or CCC/LCM, is TEXT. The default transfer type for QSAM is BINARY. VSAM, IMS and DB/2 cannot be overridden. The MEMBER parameter can specify a specific mainframe member name, or can include special filter characters to allow multiple imports to occur based on the special filter characters that you specify. These special filter characters are: • * means any characters may follow • ? means any character in this position • + means the character in this position must be non-blank • - means the character in this position must be blank • \ means the character in this position must be non-numeric • / means the character in this position must be numeric Page 2 of 4
Using Mainframe Access (MFA) from a COBOL program Import command examples: JES To import from the mainframe JES2 or JES3 spool: MFDAS IMPORT filename FROM JES JOB#####|filter PDS To import from a Partitioned data set: MFDAS IMPORT [BINARY | TEXT] filename FROM PDS pdsname MEMBER memname|filter Librarian To import from a Librarian data set: MFDAS IMPORT [BINARY | TEXT] filename FROM LIB libname MEMBER memname|filter Panvalet To import from a Panvalet dataset: MFDAS IMPORT [BINARY | TEXT] filename FROM PAN panname MEMBER memname|filter Endevor To import from an Endevor data set: MFDAS IMPORT [BINARY | TEXT] filename FROM END ENV 'env' SYS 'sys' SUB 'sub' MEMBER memname|filter TYPE memtype CCID ccid COMMENT user comment CCC/LCM To import from a CCC/LCM data set. If you wish to lock this member out, then specify the LOCK Y parameter. MFDAS IMPORT [BINARY | TEXT] filename FROM LCM lcmname SYSTEM systemid CONFIG configid MEMBER memname|filter TYPE memtype [LOCK y] In-House System To import from your own in-house source code control system dataset: MFDAS IMPORT [BINARY | TEXT] filename FROM IHS ihsdatasetname MEMBER memname|filter QSAM To import from a QSAM data set with automatic data conversion: MFDAS IMPORT [BINARY | TEXT] filename FROM QSAM qsamname VSAM KSDS To import from a VSAM KSDS data set with automatic data conversion and produce a variable length workstation indexed file. If you wish to produce a fixed length indexed file, then use KSDS- FIXED instead of KSDS. MFDAS IMPORT filename FROM KSDS vsamksdsname VSAM ESDS To import from a VSAM ESDS data set with automatic data conversion and produce a variable Page 3 of 4
<strong>Using</strong> <strong>Mainframe</strong> <strong>Access</strong> (<strong>MFA</strong>) from a COBOL program<br />
56 A length error, at a record level, has been detected<br />
57 A general security error has been detected<br />
58 A hash code mismatch has been detected<br />
59 The remote execution failed<br />
60 The JES spool file is not an output file<br />
61 The JES spool file is not a held output file<br />
100 Syntax error in call<br />
125 Too many concurrent users are active<br />
139 The record length was too large<br />
218 The DCB is not supported. This is usually caused by trying to use RECFM=U<br />
219 The mainframe load libraries are not APF authorized<br />
220-241 Various SAF security return codes<br />
242 The component in use has not been activated on the mainframe<br />
243 Unable to write the specified file to the workstation<br />
244 Unable to read the specified file from the workstation<br />
245 The catalog search detected an error<br />
246 The catalog search did not yield any results<br />
247 The /F MFENDDRV* statement was not in FHREDIR.CFG<br />
248 The /F MFLSCDRV* statement was not in FHREDIR.CFG<br />
249 The file FHREDIR.CFG could not be located<br />
250 A communications failure occurred<br />
251 The file did not have a positive length<br />
252 An invalid mask was given<br />
253 The local access mask was not specified<br />
254 The local access mode was not set<br />
255 Invalid function was requested<br />
Importing Data<br />
You can import individual members, or a collection of members defined by a filter, from the JES<br />
spool, a partitioned dataset or source code control system or you can import entire QSAM, VSAM<br />
datasets, IMS databases or DB/2 tables with automatic data conversion to the appropriate <strong>Micro</strong><br />
<strong>Focus</strong> format. You may optionally specify a control file containing one or more commands and allow<br />
MFDAS to run them as a batch. To do this, place the commands in a control file of any name,<br />
without the preceding MFDAS parameter, then run MFDAS with the parameter @filename, where<br />
filename is the name of the control file.<br />
Text or binary transfers are possible. Use the BINARY or TEXT operand to override the default<br />
transfer type for the type. The default transfer type for PDS, Librarian, Panvalet, Endevor, or<br />
CCC/LCM, is TEXT. The default transfer type for QSAM is BINARY. VSAM, IMS and DB/2 cannot be<br />
overridden.<br />
The MEMBER parameter can specify a specific mainframe member name, or can include special filter<br />
characters to allow multiple imports to occur based on the special filter characters that you specify.<br />
These special filter characters are:<br />
• * means any characters may follow<br />
• ? means any character in this position<br />
• + means the character in this position must be non-blank<br />
• - means the character in this position must be blank<br />
• \ means the character in this position must be non-numeric<br />
• / means the character in this position must be numeric<br />
Page 2 of 4
Change language