GDDM V3R2 Base Application Programming Reference
Previous topic | Next topic | Contents | Index | Contact z/OS | Library | PDF | BOOK


IMAGTS

GDDM V3R2 Base Application Programming Reference
SC33-0868-02
Function
To start retrieval of data from an image. 



   IMAGTS      (id, proj-id, format, compression)


   APL code               1612
   GDDM RCP code          X'3C010014' (1006698516)
Parameters

id (specified by user) (fullword integer)
The application or device image for which retrieval is started. Device image identifiers are allowed, as follows:

-1
Scanner input from the current device.
0
The image on the current GDDM page.
>0
Application images.

proj-id (specified by user) (fullword integer)
The projection to be applied.

format (specified by user) (fullword integer)
The format of the image. Possible values are:

0
Default (same as 2).
1
Unformatted.
2
3193 data stream format.
3
Page printer format.
The following values of format exist to allow the entry of image data coming from a source that defines 1=black; that is, the opposite of that defined by GDDM. This feature is provided because the supported formats do not uniquely define which values map to black and which to white. If a later release of GDDM supports a level of 3193 data-stream format or page printer format that does allow polarity within the format, the sign of the operand in existing application programs will be ignored.
-1
Unformatted, where a pixel value of 1 indicates black.
-2
3193 data stream formats, where a pixel value of 1 indicates black.
-3
Page printer formats, where a pixel value of 1 indicates black.

compression (specified by user) (fullword integer)
The compression type of the image. Possible values are:

0
Default (same as 1).
1
Uncompressed.
2
MMR (IBM 8815).
3
IBM 4250.
4
IBM 3800.
Only specific combinations of format and compression are allowed; these are defined as follows: 



                                  1              2               3
                             Unformatted      3193DSF           PPF
   1  Uncompressed                X              X
   2  MMR (IBM 8815)              X              X               X
   3  IBM 4250                                                   X
   4  IBM 3800                                                   X
Where:
  • MMR = modified-modified read
  • 3193DSF = 3193 data stream format
  • PPF = page printer format.
Description
Starts a "get" sequence, that is, the retrieval of image data from a specified image. The call is followed by one or more calls to IMAGT, specifying the same image. The image data is retrieved in the specified format and compression. The retrieval process must be ended by a call to IMAGTE.
IMAGTx sequences are transfer operations and therefore a projection is applied to the data; for more information, see the GDDM Base Application Programming Guide.
While retrieval is in progress, other images can be accessed, but the specified image can only be accessed by IMAGT or IMAGTE, or it can be deleted by IMADEL.
When the source of the transfer operation is a scanner, an implicit FSFRCE is performed to ensure that the screen contents are up to date and ready for any echoing that may be done. All I/O is performed for the current page. If there is no image field in the current page, one is created. All echoing is to the current image field. The effect of echoing is such that the scanned image is transferred to the image field with the same projection; that is, as if the application had issued: 



     IMXFER (-1,0,proj-id)


   followed by FSFRCE.  Whenever possible, the echoing is performed by the
   device.  The ISCTL values are used to determine the required quality of
   echoing, and thus whether echoing is performed by the device, or by GDDM;
   for more information, see the GDDM Base Application Programming Guide.
It is not possible to start an IMAGT sequence from image -1 while an IMAPT sequence to the display (image 0) is in progress.
Principal errors
ADM3366 E
INVALID SOURCE IMAGE IDENTIFIER
ADM3367 E
SOURCE IMAGE DOES NOT EXIST
ADM3368 E
SOURCE IMAGE NOT READABLE
ADM3369 E
PROJECTION USES INCHES/METERS FOR SOURCE WITH NO RESOLUTION
ADM3373 E
INVALID IMAGE FORMAT
ADM3374 E
INVALID IMAGE COMPRESSION
ADM3375 E
COMPRESSION n1 IS NOT VALID FOR FORMAT n2
ADM3378 E
IMAGE ENTRY OR RETRIEVAL ALREADY INITIALIZED FOR IMAGE n
ADM3388 E
IMAGE NOT SUITABLE FOR GET SEQUENCE IN REQUESTED FORMAT
ADM3390 E
IMAGE (AFTER PROJECTION APPLIED) UNSUITABLE FOR REQUESTED FORMAT
ADM3391 W
ONLY n1 OUT OF n2 TRANSFORMS WILL BE PROCESSED
ADM3392 I
OVERLAPPED TARGET RECTANGLES MAY GIVE INCORRECT RESULTS
ADM3393 I
SCALE FACTOR n1 APPROXIMATED TO n2
ADM3394 I
SCALING ALGORITHM n1 APPROXIMATED TO n2
ADM3401 E
INVALID PROJECTION IDENTIFIER
ADM3402 E
PROJECTION DOES NOT EXIST
ADM3403 W
NO IMAGE DATA TRANSFERRED
ADM3477 E
SCANNER NOT READY. MAY BE SWITCHED OFF
ADM3478 E
NO PAPER IN SCANNER
ADM3479 E
SCANNER LAMP INTENSITY IS TOO LOW
ADM3480 E
SCANNER PAPER JAM
ADM3481 E
UNRECOVERABLE SCANNER ERROR OCCURRED
ADM3482 E
PROJECTION WOULD REQUIRE SCANNER TO RESCAN
ADM3483 E
SCANNER DISCONNECTED
ADM3484 W
GRAY-SCALE TRANSFORMS MAY BE SIMPLIFIED TO MEET SCANNER CAPABILITIES

Go to the previous page Go to the next page
Notices | Terms of use | Support | Contact z/OS



Copyright IBM Corporation 1990, 2012