{
    "content": [
        {
            "type": "text",
            "text": "# vmsish (man)\n\n## NAME\n\nvmsish - Perl pragma to control VMS-specific language features\n\n## SYNOPSIS\n\nuse vmsish;\nuse vmsish 'status';        # or '$?'\nuse vmsish 'exit';\nuse vmsish 'time';\nuse vmsish 'hushed';\nno vmsish 'hushed';\nvmsish::hushed($hush);\nuse vmsish;\nno vmsish 'time';\n\n## DESCRIPTION\n\nIf no import list is supplied, all possible VMS-specific features are assumed.  Currently,\nthere are four VMS-specific features available: 'status' (a.k.a '$?'), 'exit', 'time' and\n'hushed'.\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n"
        }
    ],
    "structuredContent": {
        "command": "vmsish",
        "section": "",
        "mode": "man",
        "summary": "vmsish - Perl pragma to control VMS-specific language features",
        "synopsis": "use vmsish;\nuse vmsish 'status';        # or '$?'\nuse vmsish 'exit';\nuse vmsish 'time';\nuse vmsish 'hushed';\nno vmsish 'hushed';\nvmsish::hushed($hush);\nuse vmsish;\nno vmsish 'time';",
        "tldr_summary": null,
        "tldr_examples": [],
        "tldr_source": null,
        "flags": [],
        "examples": [],
        "see_also": [],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 13,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 76,
                "subsections": []
            }
        ],
        "sections": {
            "NAME": {
                "content": "vmsish - Perl pragma to control VMS-specific language features\n",
                "subsections": []
            },
            "SYNOPSIS": {
                "content": "use vmsish;\n\nuse vmsish 'status';        # or '$?'\nuse vmsish 'exit';\nuse vmsish 'time';\n\nuse vmsish 'hushed';\nno vmsish 'hushed';\nvmsish::hushed($hush);\n\nuse vmsish;\nno vmsish 'time';\n",
                "subsections": []
            },
            "DESCRIPTION": {
                "content": "If no import list is supplied, all possible VMS-specific features are assumed.  Currently,\nthere are four VMS-specific features available: 'status' (a.k.a '$?'), 'exit', 'time' and\n'hushed'.\n\nIf you're not running VMS, this module does nothing.\n\n\"vmsish status\"\nThis makes $? and \"system\" return the native VMS exit status instead of emulating the\nPOSIX exit status.\n\n\"vmsish exit\"\nThis makes \"exit 1\" produce a successful exit (with status SS$NORMAL), instead of\nemulating UNIX exit(), which considers \"exit 1\" to indicate an error.  As with the\nCRTL's exit() function, \"exit 0\" is also mapped to an exit status of SS$NORMAL, and\nany other argument to exit() is used directly as Perl's exit status.\n\n\"vmsish time\"\nThis makes all times relative to the local time zone, instead of the default of\nUniversal Time (a.k.a Greenwich Mean Time, or GMT).\n\n\"vmsish hushed\"\nThis suppresses printing of VMS status messages to SYS$OUTPUT and SYS$ERROR if Perl\nterminates with an error status, and allows programs that are expecting \"unix-style\"\nPerl to avoid having to parse VMS error messages.  It does not suppress any messages\nfrom Perl itself, just the messages generated by DCL after Perl exits.  The DCL symbol\n$STATUS will still have the termination status, but with a high-order bit set:\n\nEXAMPLE:\n$ perl -e\"exit 44;\"                          Non-hushed error exit\n%SYSTEM-F-ABORT, abort                       DCL message\n$ show sym $STATUS\n$STATUS == \"%X0000002C\"\n\n$ perl -e\"use vmsish qw(hushed); exit 44;\"   Hushed error exit\n$ show sym $STATUS\n$STATUS == \"%X1000002C\"\n\nThe 'hushed' flag has a global scope during compilation: the exit() or die() commands\nthat are compiled after 'vmsish hushed' will be hushed when they are executed.  Doing a\n\"no vmsish 'hushed'\" turns off the hushed flag.\n\nThe status of the hushed flag also affects output of VMS error messages from\ncompilation errors.   Again, you still get the Perl error message (and the code in\n$STATUS)\n\nEXAMPLE:\nuse vmsish 'hushed';    # turn on hushed flag\nuse Carp;          # Carp compiled hushed\nexit 44;           # will be hushed\ncroak('I die');    # will be hushed\nno vmsish 'hushed';     # turn off hushed flag\nexit 44;           # will not be hushed\ncroak('I die2'):   # WILL be hushed, croak was compiled hushed\n\nYou can also control the 'hushed' flag at run-time, using the built-in routine\nvmsish::hushed().  Without argument, it returns the hushed status.  Since\nvmsish::hushed is built-in, you do not need to \"use vmsish\" to call it.\n\nEXAMPLE:\nif ($quietexit) {\nvmsish::hushed(1);\n}\nprint \"Sssshhhh...I'm hushed...\\n\" if vmsish::hushed();\nexit 44;\n\nNote that an exit() or die() that is compiled 'hushed' because of \"use vmsish\" is not\nun-hushed by calling vmsish::hushed(0) at runtime.\n\nThe messages from error exits from inside the Perl core are generally more serious, and\nare not suppressed.\n\nSee \"Perl Modules\" in perlmod.\n\n\n\nperl v5.34.0                                 2026-06-23                                vmsish(3perl)",
                "subsections": []
            }
        }
    }
}