$GunZip: Difference between revisions
Jump to navigation
Jump to search
Automatically generated page update |
No edit summary |
||
| (11 intermediate revisions by one other user not shown) | |||
| Line 2: | Line 2: | ||
<span class="pageSubtitle">Decompress a longstring with GUNZIP</span> | <span class="pageSubtitle">Decompress a longstring with GUNZIP</span> | ||
<p class="warn"><b>Note: </b> | <p class="warn"><b>Note: </b>Many $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $GunZip function is <var>[[Gunzip (String function)|Gunzip]]</var>.</p> | ||
This function extracts information from a GZIP-format longstring. | This function extracts information from a GZIP-format longstring. | ||
The $GunZip function accepts two arguments and returns a longstring result. | The $GunZip function accepts two or three arguments and returns a longstring result. | ||
==Syntax== | ==Syntax== | ||
<p class="syntax"><span class="term">%lstrc</span> = <span class="literal">$GunZip</span>(%lstr, type) | <p class="syntax"><span class="term">%lstrc</span> = <span class="literal">$GunZip</span>(%lstr, type, [<span class="term">option</span>]) | ||
</p> | </p> | ||
<p> | <p> | ||
| Line 15: | Line 15: | ||
<p>%lstrc is the returned longstring.</p> | <p>%lstrc is the returned longstring.</p> | ||
The first argument, the longstring to be decompressed, is required. The string must be in GZIP format. | The first argument, the longstring to be decompressed, is required. The string must be in GZIP format. | ||
The second argument is a string indicating what information should be extracted from the GZIP-format longstring. This argument is optional; if it is not specified, <tt>DATA</tt> is assumed, and the longstring is decompressed into the result longstring. Valid options and their meanings are: | The second argument is a string indicating what information should be extracted from the GZIP-format longstring. This argument is optional; if it is not specified, <tt>DATA</tt> is assumed, and the longstring is decompressed into the result longstring. Valid options and their meanings are: | ||
| Line 30: | Line 30: | ||
</td></tr> | </td></tr> | ||
</table> | </table> | ||
The third argument is an optional string that controls the decompression method. [Introduced in Model 204 version 8.0] | |||
<table class="syntaxTable"> | |||
<tr><th><var>SOFTWARE</var></th> | |||
<td>Forces the use of software decompression, bypassing the DFLTCC hardware instruction even when it is available on the processor (IBM z15 and above). This can be useful for diagnostic purposes or when byte-for-byte reproducibility with pre-8.0 behavior is required.</td></tr> | |||
</table> | |||
<p>If the third argument is omitted, hardware decompression is used automatically when DFLTCC is available, falling back to software decompression on older processors.</p> | |||
==Usage notes== | ==Usage notes== | ||
<ul> | <ul> | ||
<li> If an invalid option is passed, or if compression is not enabled for the current run, the request is cancelled. | <li> If an invalid option is passed, or if compression is not enabled for the current run, the request is cancelled. | ||
<li> The NCMPBUF parameter must be set by User 0 before the $GZip function can be used. If $GunZip is called with NCMPBUF = 0, the request is cancelled. | <li> The NCMPBUF parameter must be set by User 0 before the $GZip function can be used. If $GunZip is called with NCMPBUF = 0, the request is cancelled. | ||
</ul> | </ul> | ||
| Line 40: | Line 49: | ||
==Examples== | ==Examples== | ||
In the following example, | In the following example, | ||
<tt>%ls</tt> is set to the uncompressed version of the given string The <tt>DATA</tt> value default is implied, since no second argument is given. | <tt>%ls</tt> is set to the uncompressed version of the given string The <tt>DATA</tt> value default is implied, since no second argument is given. | ||
| Line 46: | Line 55: | ||
</p> | </p> | ||
In the following example, | In the following example, | ||
<tt>%dt</tt> is set to the last modification date and time of the file contained in the GZIP longstring. | <tt>%dt</tt> is set to the last modification date and time of the file contained in the GZIP longstring. | ||
<p class="code"> %dt = $GunZip(%lsgz, 'TIME') | <p class="code"> %dt = $GunZip(%lsgz, 'TIME') | ||
</p> | |||
The following example forces software decompression: | |||
<p class="code"> %ls = $GunZip(%lsgz, 'DATA', 'SOFTWARE') | |||
</p> | </p> | ||
''Note: GZIP-format files can be created with the function [[$GZip]] as well as other file compression utilities.'' | ''Note: GZIP-format files can be created with the function [[$GZip]] as well as other file compression utilities.'' | ||
==Products authorizing {{PAGENAMEE}}== | ==Products authorizing {{PAGENAMEE}}== | ||
<ul class="smallAndTightList"> | <ul class="smallAndTightList"> | ||
<li>[[Sirius functions]]</li> | <li>[[List of $functions|Sirius functions]]</li> | ||
<li>[[Fast/Unload User Language Interface]]</li> | <li>[[Fast/Unload User Language Interface]]</li> | ||
<li>[ | <li>[[Media:JoclrNew.pdf|Janus Open Client]]</li> | ||
<li>[[Janus Open Server]]</li> | <li>[[Media:JosrvrNew.pdf|Janus Open Server]]</li> | ||
<li>[[Janus Sockets]]</li> | <li>[[Janus Sockets]]</li> | ||
<li>[[Janus Web Server]]</li> | <li>[[Janus Web Server]]</li> | ||
<li> | <li>Japanese functions</li> | ||
<li>[[Sir2000 Field Migration Facility]]</li> | <li>[[Media:SirfieldNew.pdf|Sir2000 Field Migration Facility]]</li> | ||
</ul> | </ul> | ||
Latest revision as of 13:55, 19 May 2026
Decompress a longstring with GUNZIP
Note: Many $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $GunZip function is Gunzip.
This function extracts information from a GZIP-format longstring.
The $GunZip function accepts two or three arguments and returns a longstring result.
Syntax
%lstrc = $GunZip(%lstr, type, [option])
%lstrc is the returned longstring.
The first argument, the longstring to be decompressed, is required. The string must be in GZIP format.
The second argument is a string indicating what information should be extracted from the GZIP-format longstring. This argument is optional; if it is not specified, DATA is assumed, and the longstring is decompressed into the result longstring. Valid options and their meanings are:
Options
| DATA | Indicates that the data in the GZIP longstring is extracted. This is the default. |
|---|---|
| TIME | Indicates that the date and time, known as the "modification time," is returned (in the form YYYY-MM-DD HH:MI:SS). |
| NAME | Indicates that the internal name of the GZIP entity is returned in the result. If no internal name is present, the null string is returned. |
The third argument is an optional string that controls the decompression method. [Introduced in Model 204 version 8.0]
| SOFTWARE | Forces the use of software decompression, bypassing the DFLTCC hardware instruction even when it is available on the processor (IBM z15 and above). This can be useful for diagnostic purposes or when byte-for-byte reproducibility with pre-8.0 behavior is required. |
|---|
If the third argument is omitted, hardware decompression is used automatically when DFLTCC is available, falling back to software decompression on older processors.
Usage notes
- If an invalid option is passed, or if compression is not enabled for the current run, the request is cancelled.
- The NCMPBUF parameter must be set by User 0 before the $GZip function can be used. If $GunZip is called with NCMPBUF = 0, the request is cancelled.
Examples
In the following example, %ls is set to the uncompressed version of the given string The DATA value default is implied, since no second argument is given.
%ls = $GunZip(%lsgz)
In the following example,
%dt is set to the last modification date and time of the file contained in the GZIP longstring.
%dt = $GunZip(%lsgz, 'TIME')
The following example forces software decompression:
%ls = $GunZip(%lsgz, 'DATA', 'SOFTWARE')
Note: GZIP-format files can be created with the function $GZip as well as other file compression utilities.
Products authorizing $GunZip
- Sirius functions
- Fast/Unload User Language Interface
- Janus Open Client
- Janus Open Server
- Janus Sockets
- Janus Web Server
- Japanese functions
- Sir2000 Field Migration Facility